OpenFigureFromAnnotation()

Summary

Creates a new figure window from a figure that appears in a layout.

Syntax

figure_name = OpenFigureFromAnnotation(string layout_name, integer id, array options)

Argument Contents
layout_name The name of the layout containing the figure
id The ID of the figure annotation in the layout
Option Type Contents
Activate Macro String The name of a macro that is called whenever the window is activated
Aspect Ratio 2 integers The aspect ratio of the window (height, width)
Click Macro String The name of a macro that is called when the user clicks on the window
Close Macro String The name of a macro that is called when the user closes the window from the system menu
Done Macro String The name of a macro that is called after the window is closed
Menu String The menu associated with the window
Position 2 integers The screen location of the window (x, y)
Size 2 integers The screen size of the window (x,y)
Toolbar String The toolbar associated with the map window

Returns

The name of the figure window.

Notes

  • The position and size of the window are expressed as percentages of Maptitude's frame.

  • The attached menu and toolbar are automatically displayed whenever the figure window is activated.

  • If the menu, toolbar, activate macro, close macro, or click macro is not specified, OpenFigureFromAnnotation() uses the default specified with SetDefaults(). If a specific default for a figure window was not specified with SetDefaults(), then OpenFigureFromAnnotation() uses the generic default.

  • For a full list of GISDK functions for annotations, see Freehand Items (Annotations).

Error Codes

Error Type Meaning
Error An invalid option was specified
NotFound The specified layout or figure annotation does not exist

See Also

Function Summary
CloseFigure() Closes a figure window
CreateFigure() Creates a new window containing a figure
OpenFigure() Creates a figure window from a file
SaveFigure() Saves a figure to a file
SetDefaults() Sets default menus, toolbars, and macros.