LAnnotation::SetOptions

#include "ltwrappr.h"

L_INT LAnnotation::SetOptions(uOptions)

L_UINT uOptions;

/* annotation options to be set */

Sets user interface and other annotation options introduced in version 14.5. This function is available in the Document/Medical Toolkits.

Parameter

Description

uOptions

Options to enable. Use a bitwise OR to specify more than one value

 

Value

Meaning

 

OPTIONS_NEW_STAMP_METAFILES

[0x0001] Uses the new rubber stamp styles.

 

OPTIONS_NEW_TOOLBAR

[0x0002] Displays the new XP style annotation toolbar

 

OPTIONS_NEW_ALPHA

[0x0004] Displays new "alpha" option in the Fill mode dialog

 

OPTIONS_NEW_ROTATE

[0x0008] Displays rotate handles on objects in design mode

 

OPTIONS_NEW_SIDE_HANDLES

[0x0010] Displays side handles on rectangular objects in design mode

 

OPTIONS_NEW_MULTI_SELECT

[0x0020] Displays a multi-select outline of multiply selected objects, along with the new multi-select resize behavior

 

OPTIONS_NEW_CURSORS

[0x0040] Displays different cursors for each of the annotation tools, and when hovering over handles in design mode.

 

OPTIONS_NEW_ESC_CANCEL

[0x0080] Allows the user to cancel current action by pressing ESC. Actions include annotation creation and manipulation.

 

OPTIONS_NEW_CALIBRATE_RULER

[0x0100] Enables ruler calibrate feature in design mode

 

OPTIONS_NEW_DOT_DASH_LINES

[0x0200] Draws the dash and dot line styles with line width greater than 1 pixel.

 

OPTIONS_NEW_TEXT_OPTIONS

[0x0400] Enables new text annotation options including show/hide text, show/hide border, and changing text color.

 

OPTIONS_NEW_ALL

Enables ALL the new options. The value for this constant is the logical "or" of all the above flags.

Returns

SUCCESS

The function was successful.

< 1

An error occurred. Refer to Return Codes.

Comments

In version 14.5 of LEADTOOLS, many changes to annotations are being introduced. Some of these features change the way annotations look. Other features change the behavior of the user interface (automated mode). To maintain backward compatibility, the new features are disabled by default. To enable these features, call LAnnotation::SetOptions with the desired flags. To get the current Version 14.5 options, call the LAnnotation::GetOptions function. For more information, refer to New Annotation Features of Version 14.5.

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.

See Also

Functions:

LAnnotation::GetOptions, ANNBUTTON, LAnnToolBar::FreeToolBarButtons, LAnnToolBar::GetToolBarButtons, LAnnToolBar::SetToolBarButtons, LAnnotation::GetFillModeExt, LAnnotation::SetFillModeExt, LAnnAutomation::SetAutoCursor, LAnnAutomation::GetAutoCursor, LAnnContainer::Save, LAnnContainer::SaveOffset, LAnnContainer::SaveMemory, LAnnContainer::LoadOffset, LAnnContainer::LoadMemory, LAnnotation::SetTextOptions, LAnnotation::GetTextOptions, LAnnToolBar::Create, LAnnToolBar::GetToolChecked, LAnnToolBar::SetToolChecked, LAnnToolBar::IsButtonVisible, LAnnToolBar::SetButtonVisible, LAnnToolBar::GetToolBarInfo, LAnnToolBar::SetToolBarColumns, LAnnToolBar::SetToolBarRows, LAnnotation::GetRotateOptions, LAnnotation::SetRotateOptions, LAnnotation::CalibrateRuler

Topics:

New Annotation Features of Version 14.5

 

Calibrating Annotation Ruler Objects

 

Annotation Functions (Document/Medical only) Displaying Annotations

Example

// The following example demonstrates how to enable and disable the new
// 'side handle' annotation feature in version 14.5. To see how this works,
// paste this example into the main annotation demo, draw a rectangle,
// and select it before calling this function. The example toggles the feature.
void SetOptionsExample(LAnnRectangle& annrect)
{
   L_TCHAR *pszMsg = NULL;
   L_INT nRet = SUCCESS;
   L_UINT uOptions = 0;

   nRet = annrect.GetOptions(&uOptions);
   if (nRet != SUCCESS)
      return ;

   if (uOptions & OPTIONS_NEW_SIDE_HANDLES)
   {
      uOptions &= ~OPTIONS_NEW_SIDE_HANDLES;
      pszMsg = TEXT("Draw a rectangular object and select it. Note there are no side handles. Run this example again to enable the side handles.");
   }
   else
   {
      uOptions |= OPTIONS_NEW_SIDE_HANDLES;
      pszMsg = TEXT("Draw a rectangular object and select it. Note the side handles. Run this example again to disable the side handles.");
   }

   nRet = annrect.SetOptions(uOptions);
   if (nRet != SUCCESS)
      return ;

   MessageBox( NULL, pszMsg, TEXT("Notice"), MB_OK);
}