L_AnnSetAutoOptions

#include "l_bitmap.h"

L_LTANN_API L_INT L_AnnSetAutoOptions(hObject, uFlags)

HANNOBJECT hObject;

/* handle to the annotation object */

L_UINT uFlags;

/* flags that determine the options to set */

Sets options for the automation object.

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

Parameter

Description

hObject

Handle to the annotation object.

uFlags

Flags that determine the options to set. Possible values are:

 

Value

Meaning

 

ANNAUTO_TABBEDDIALOG

Combine the dialog boxes that describe most of the object properties into one tabbed dialog box. Only dialog boxes that are not system dependent can be tabbed. The dialog boxes that are not tabbed are Font, Color, and File. If this flag is not set, the dialogs are displayed as in previous versions of LEADTOOLS.

 

ANNAUTO_REVERSEEDITKEYS

Reverse the behavior of the Enter key and the Ctrl + Enter key combination for Text, Note and Push Pin objects. By default, for the Text, Note and Push pin objects, pressing the Enter key ends the text input, while the Ctrl + Enter key combination allows the user to add a new line to the text input. Setting this flag reverses these behaviors.

Returns

SUCCESS

The function was successful.

< 1

An error occurred. Refer to Return Codes.

Comments

By default, the dialogs are combined in a tabbed dialog box.

If a tabbed dialog box is used, the caption of the dialog box will be one of the following:

Default Properties

Selected Properties

Container Properties

Pointer Properties

Audio Properties

Button Properties

Ellipse Properties

Freehand Properties

Hilite Properties

Hotspot Properties

Line Properties

Note Properties

Polygon Properties

Polyline Properties

Rectangle Properties

Redact Properties

Stamp Properties

Text Properties

Automation Properties

Ruler Properties

Cross product Properties

Point Properties

Protractor Properties

Video Properties

Pushpin Properties

Freehand Hot Spot Properties

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_AnnGetAutoOptions, L_AnnSetAutoHilightPen, L_AnnSetAutoSnapCursor, L_AnnGetAutoSnapCursor

Topics:

Annotation Functions: Implementing Automation

 

Implementing Annotations

 

Automated User Interface for Annotations

 

Implementing an Automated Annotation Program

 

Altering Annotation Object Settings

Example

 L_INT AnnSetAutoOptionsExample(HANNOBJECT  hAutoObject)
{
   L_INT    nRet;
   L_UINT   uFlags;

   nRet = L_AnnGetAutoOptions(hAutoObject, &uFlags);
   if (nRet == SUCCESS)
   {
      if (uFlags != 0)
         uFlags = 0;
      else
         uFlags = ANNAUTO_TABBEDDIALOG;
      L_AnnSetAutoOptions(hAutoObject, uFlags);
   }
   else
   {
      MessageBox(NULL, TEXT("Error getting auto options."), TEXT(""), MB_OK);
      return nRet;
   }
   return SUCCESS;
}