Collapse All Expand All

LAnnAutomation::SetAutoOptions

#include "ltwrappr.h"

virtual L_INT LAnnAutomation::SetAutoOptions(uFlags)

L_UINT uFlags;

/* flags that determine the options to set */

Sets options for the automation object.

Parameter	Description
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

Win32, x64.

See Also

Functions:	LAnnAutomation::GetAutoOptions, LAnnAutomation::SetAutoHilightPen, LAnnotation::SetAutoSnapCursor, LAnnotation::GetAutoSnapCursor, LAnnAutomation::GetAutoHilightPen
Topics:	Annotation Functions: Implementing Automation
	Implementing Annotations
	Automated User Interface for Annotations

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