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 and Medical Imaging 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;
}