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;
}