Creating Windows

Windows are created by the following GISDK functions:

GISDK Function	Summary
CreateCOMControl()	Creates a new COM control window
CreateEditor()	Creates a new editor window
CreateEditorByQuery()	Creates an editor displaying the results of an SQL query
CreateFigure()	Creates a new figure window
CreateLayout()	Creates a new layout window
CreateMap()	Creates a new, empty map window
OpenEditor()	Creates an editor from a file
OpenEditorFromAnnotation()	Creates a new editor window from an editor that appears in a layout
OpenFigure()	Creates a figure from a file
OpenFigureFromAnnotation()	Creates a new figure window from a figure that appears in a layout
OpenLayout()	Creates a layout from a file
OpenMap()	Opens a map file and displays it in a map window
OpenMapFromAnnotation()	Creates a new map window from a map that appears in a layout

These GISDK functions all return the name of the window that was created, and have numerous options that control how the window operates. Here is a quick summary:

Option	What it does
Menu	Names the menu that is associated with the window
Toolbar	Names the toolbar that is associated with the window
Position	Sets the location of the upper-left corner of the window within the application window
Size	Sets the size of the window within the application window
Activate Macro	Specifies the name of a macro that is run automatically when the window is activated
Close Macro	Specifies the name of a macro that is run automatically when the user closes the window by choosing the Close option from the System menu
Done Macro	Specifies the name of a macro that is run automatically after the window is closed

Some of these options can be changed after a particular window is created. These options are described in detail in the topics that follow. The following GISDK functions are used to manage window options:

GISDK Function	What it does
GetEditorOption()	Gets the value of an option from an editor window
GetLayoutOptions()	Gets the current option settings for a layout
GetMapOptions()	Gets the value of options for a map window
SetEditorOption()	Sets an option for an editor window
SetEditorOptionEx()	Sets an option for an editor window
SetLayoutOptions()	Sets options for a layout
SetMapOptions()	Sets options for a map window

Map, editor, and layout windows offer additional options, documented in full in the listing of GISDK functions. Here are a few examples:

Window type	Optional settings
Map	Initial scale and center, scale-change macro
Editor	Font size/style, read-only, grid, selection set highlighting, locked columns, highlight macro
Layout	Paper cut lines, rulers, and grid settings