L_AnnSetAutoDrawEnable

#include "l_bitmap.h"

L_LTANN_API L_INT L_AnnSetAutoDrawEnable(hObject, fEnable)

HANNOBJECT hObject;	/* handle to an annotation automation object */
L_BOOL fEnable;	/* flag that indicates whether to enable or disable automated drawing */

Enables or disables automated drawing, using the left mouse button, in design mode.

This function is available in the Document and Medical Imaging toolkits.

Parameter	Description
hObject	Handle to an annotation automation object.
fEnable	Flag that indicates whether the left mouse button is used to draw automated annotation objects in design mode. Possible values are:
	Value	Meaning
	TRUE	The left mouse button is enabled for automated drawing.
	FALSE	The left mouse button is disabled for automated drawing.

Returns

SUCCESS	The function was successful.
< 1	An error occurred. Refer to Return Codes.

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_AnnSetAutoMenuEnable, L_AnnGetAutoMenuEnable, L_AnnGetAutoDrawEnable, L_AnnSetAutoText, L_AnnSetAutoHilightPen, L_AnnSetAutoSnapCursor, L_AnnGetAutoSnapCursor
Topics:	Annotation Functions: Implementing Automation
	Annotation Functions: Working with the Toolbar
	Implementing Annotations
	Automated User Interface for Annotations
	Implementing an Automated Annotation Program
	Altering Annotation Object Settings

Example

This example toggles between enabling and disabling automated drawing.

 L_INT AnnSetAutoDrawEnableExample(HANNOBJECT hAutomation)
{
   L_INT nRet;
   L_BOOL fEnable; /* Is drawing enabled? */

   /* Is automated drawing disabled? */
   nRet = L_AnnGetAutoDrawEnable(hAutomation, & fEnable);
   if(nRet != SUCCESS)
      return nRet;
   if (fEnable == FALSE)
   {
      MessageBox (NULL, TEXT("Drawing is disabled. It will be enabled"), TEXT("Notice"), MB_OK);
      nRet = L_AnnSetAutoDrawEnable(hAutomation, TRUE);
      if(nRet != SUCCESS)
         return nRet;
   }
   else
   {
      MessageBox(NULL, TEXT("Drawing is enabled. It will be disabled."), TEXT("Notice"), MB_OK);
      nRet = L_AnnSetAutoDrawEnable(hAutomation, FALSE);
      if(nRet != SUCCESS)
         return nRet;
   }
   return SUCCESS;
}