Generic UI Controllers: 2 Standard Controllers

GEOS SDK TechDocs

1 Controller Features and Functions

3 Using Controllers

This section lists the various controller classes exported by system objects and libraries. Many are part of the GEOS UI; others are part of particular libraries. Some are system-wide (such as the ColorSelectorClass); others are object-specific (such as the InkControllerClass).

All of these controllers are set up to work with GenToolControlClass and GenToolGroupClass . When a GenToolControl object is also included in an application, users may set up menus and floating toolboxes however they like with the various tools from the controller's lists. For more information on the GenToolControl and how it is used, see Using Tools and GenToolControlClass .

• GenToolControlClass
This controller class provides the UI for the user to select where other controller tools appear. Controller tools must be specified by the individual controller classes; GenToolControlClass simply manages them according to the user's specifications. Individual tools may be placed in a floating tool box, in an application's tool bar, alongside the active display, alongside the primary display, or other places. GenToolControlClass is described in full in Using Controllers .
• GenEditControlClass
This controller class provides the Edit menu with the Undo, Cut, Copy, Paste, Select All, and Delete triggers. This controller will cooperate fully with most system objects such as the text, graphic object, spreadsheet, and Ink objects. The GenEditControl sends out MSG_META_CUT , MSG_META_COPY , etc., to these objects. GenEditControlClass is described in the Clipboard chapter.
• GenViewControlClass
This controller class provides a View menu with the functions for changing a GenView's scale, paging, scrolling, aspect ratio, and other features. It is described in full in the GenView chapter.
• GenDisplayControlClass
This controller class provides the UI for a multiple display interface. It works with the GenDisplayGroup and GenDisplay objects and is described in full in the GenDisplay chapter.
• GenDocumentControlClass
This controller class provides all the functions of the File menu including New, Open, Use Template, Close, Save, Save As, and Revert. It also interacts with the GenDocument and GenDocumentGroup objects to manage how the user interacts with documents in general. GenDocumentControlClass is described in full in the Documents chapter.
• GenPageControlClass
This controller class provides the UI for a user to go to a previous, next or specified page. It is described in full in GenPageControlClass .
• PrintControlClass , PageSizeControlClass
Both of these controller classes are exported by the spool object library. Both are described in full in the Printing chapter.
• ImportControlClass , ExportControlClass
These controller classes provide the UI and functions necessary for the user to select files for importing and exporting. They are exported by the Impex library are described in full in the Impex chapter.
• InkControlClass
This controller class provides the tool interface for working with Ink-related tools. It is exported by the pen library and is described in full in the Pen Object library chapter.
• ColorSelectorClass
This controller class provides the UI for a user to set a color using either the palette index or a set of RGB values, to set a draw mask, and to set an area fill pattern. ColorSelectorClass is described in ColorSelectorClass .
• StyleSheetControlClass
This controller class provides the UI and functions necessary for a user to define and change an application-specific style type and apply style changes. It works primarily with the Text library and graphic object library.
• FloatFormatClass
This controller class provides the UI and functions to allow the user to format numerical values into text (for example scientific notation, dates and times, etc.) This controller is described in The Float Format Controller .
• Various Text Controller Classes
  The text library exports a number of controllers that are specific to text operations. These classes are described in the Text Object chapter.
• Various Ruler Controller Classes
  The ruler library exports a number of controllers that manage the user's interactions and control over the ruler objects. These controller classes include RulerTypeControlClass , GuideCreateControlClass , and RulerGridControlClass . They are described in full in the Ruler chapter.

GEOS SDK TechDocs

1 Controller Features and Functions

3 Using Controllers