In This Topic ▼

LAnnAutomation::SetAutoOptions

Summary

Sets options for the automation object.

Syntax

#include "ltwrappr.h"

virtual L_INT LAnnAutomation::SetAutoOptions(uFlags)

Parameters

L_UINT 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

Value	Meaning
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 HotSpot 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

Win32, x64.

Example

This example uses the following member variables:
m_AnnotationWindow should be created and initialized prior to the example
This example toggles the tabbed dialog box behavior

L_INT LAnnAutomation_SetAutoOptionsExample(LAnnotationWindow m_AnnotationWindow)  
{ 
   L_INT nRet; 
   L_UINT uFlags; 
 
   nRet = m_AnnotationWindow.GetAutomationObject().GetAutoOptions(&uFlags); 
   if(nRet != SUCCESS) 
      return nRet; 
   uFlags = uFlags ? 0 : ANNAUTO_TABBEDDIALOG; 
   nRet = m_AnnotationWindow.GetAutomationObject().SetAutoOptions(uFlags); 
   if(nRet != SUCCESS) 
      return nRet; 
 
   return SUCCESS; 
}