OpenFigure()

Summary

Creates a figure window from a file.

Syntax

figure_name = OpenFigure(string file_name, array options)

Argument Contents
file_name The path and file name of the figure
Options 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 the Maptitude 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, CreateFigure() uses the default specified with SetDefaults(). If a figure window specific default was not specified with SetDefaults() then CreateFigure() uses the generic default.

Example

figure = OpenFigure(c:\\myfile.fig",
{{"Position", 0, 0},
{"Size", 100, 100}})

Error Codes

Error Type Meaning
Error The file_name is invalid or the file could not be opened or has the wrong format or an invalid option was specified

See Also

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