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