Registering toolsets

Modules can include toolsets simply by registering them. Toolsets that are registered with a module will be available when that module is the current module.

To register a toolset, you supply a pointer to the toolset along with bit flags that specify where in the GUI the toolset has defined components. The following locations are supported:

FLAG LOCATION IN GUI
GUI_IN_NONE Toolset has no components in standard locations.
GUI_IN_MENUBAR Toolset has components in the menu bar.
GUI_IN_TOOL_PANE Toolset has components in the Tools menu pull down pane.
GUI_IN_TOOLBAR Toolset has components in the toolbar.
GUI_IN_TOOLBOX Toolset has components in the toolbox.

The example in GUI module example registers a toolset that contains elements in the main menu bar and the Tools menu.

If you do not specify a flag in an area in which you have created some GUI components, those components will not be shown in the application.