Gets the currently set user interface and other annotation options.


#include "l_bitmap.h"



L_UINT *puOptions

Address of the variable to be updated with annotation options. Use a bitwise OR to specify more than one value. Possible values are:

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 multiselect 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 the ruler calibration feature in design mode.
OPTIONS_NEW_DOT_DASH_LINES [0x0200] Draws the dash and dot line styles with line widths 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_MULTILINE_DRAW [0x1000] Two exactly equal points will cancel the object creation.
OPTIONS_NEW_ALL Enables ALL the new options. The value for this constant is the logical "or" of all the above flags.


Value Meaning
SUCCESS The function was successful.
< 1 An error occurred. Refer to Return Codes.


Some of these features change the way annotations look. Other features change the behavior of the user interface (automated mode). To maintain backward compatibility, new features are disabled by default. To enable these features, call L_AnnSetOptions with the desired flags. To get the current options, call L_AnnGetOptions. For a description of the changes, refer to Annotation Features.

Required DLLs and Libraries


Win32, x64.

See Also




For an example, refer to L_AnnSetOptions.

Help Version 22.0.2023.7.11
Products | Support | Contact Us | Intellectual Property Notices
© 1991-2023 LEAD Technologies, Inc. All Rights Reserved.

LEADTOOLS Raster Imaging C API Help

Products | Support | Contact Us | Intellectual Property Notices
© 1991-2023 LEAD Technologies, Inc. All Rights Reserved.