Progress
ADM 2 Guide


Using SmartToolbars

A SmartToolbar is a SmartObject that provides a toolbar and/or menu interface to application commands that perform various actions; for example, performing navigation and transaction actions in the current object. You can contain a SmartToolbar in a SmartWindow but not in a SmartFrame or a SmartDialog, and you can put only one SmartToolbar instance in a given SmartWindow.

Progress provides the prebuilt master toolmenu.w for the SmartToolbar. You can modify this master to create a new SmartToolbar with specialized functions, so the ADM does not include a SmartToolbar template.

By default, a SmartToolbar instance includes both a toolbar and a menu. See the "Customizing SmartToolbars" section for information on changing this.

The SmartToolbar provides the application user with the ability to perform the following groups of actions:

By default, only the Navigation and Tableio Save operations are enabled. You can specify that the user can perform all or a subset of these actions. (See the "Customizing SmartToolbars" section.) Which action groups you select determine whether the SmartToolbar functions as a Navigation–Source or a Tableio–Source or both. The Wizard prompts you with possible connections.

The rules and data for the actions accessible in the SmartToolbar are defined in an action class from which the SmartToolbar inherits and are totally independent of the SmartToolbar’s layout and structure. As a result, all SmartToolbar actions have the same text, image, and interface throughout the application regardless of the SmartToolbar layout.

Customizing SmartToolbars

The simplest way to customize the SmartToolbar object is through its instance properties.
The SmartToolbar has an Instance Properties dialog box (source program: src/adm2/support/toold.w) that you can use to specify properties in a run-time instance of a SmartPanel without modifying the master object itself:

For descriptions of the SmartToolbar instance properties, see SmartObjects."

More complex SmartToolbar modifications (for example, the order and structure of icons and menus) involve modifying the SmartToolbar object itself. For some basic information, see the "Complex SmartToolbar Modifications" section in SmartObjects."


Copyright © 2004 Progress Software Corporation
www.progress.com
Voice: (781) 280-4000
Fax: (781) 280-4095