L_AnnSetWnd

#include "l_bitmap.h"

L_LTANN_API L_INT L_AnnSetWnd(hObject, hWnd)

HANNOBJECT hObject;

/* handle to the root container */

HWND hWnd;

/* window handle to assign to the object */

Sets the window handle for all objects. This function is available in the Document/Medical Toolkits.

Parameter

Description

hObject

Handle to the root container.

hWnd

The window handle to assign to the object.

Returns

SUCCESS

The function was successful.

< 1

An error occurred. Refer to Return Codes.

Comments

You set this property on the root container, and all objects in the container inherit the property.

Required DLLs and Libraries

LTANN

For a listing of the exact DLLs and Libraries needed, based on the toolkit version, refer to Files To Be Included With Your Application.

Platforms

Windows 2000 / XP/Vista.

See Also

Functions:

L_AnnGetWnd

Topics:

Annotation Functions: Global Properties

 

Implementing Annotations

 

Implementing an Automated Annotation Program

 

Implementing a Non-automated Annotation Program

 

Altering Annotation Object Settings

Example

For complete sample code, refer to the ANNOTATE example. This example updates the container object’s window handle if necessary.

 L_INT AnnSetWndExample(HWND        hWnd,HANNOBJECT  hContainer)
{
   L_INT nRet;
   HWND ObjectWnd; /* Container object's window  */

   /* Set the container's window to the current window, unless it is already current */
   nRet = L_AnnGetWnd(hContainer, &ObjectWnd);
   if(nRet != SUCCESS)
      return nRet;
   if (ObjectWnd == hWnd)
       MessageBox (NULL, TEXT("Already using the current window"), TEXT("Notice"), MB_OK);
   else
   {
       nRet = L_AnnSetWnd (hContainer, hWnd);
       if(nRet != SUCCESS)
          return nRet;
   }
   return SUCCESS;
}