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.

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

Win32, x64.

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