Release 10.1A: OpenEdge Development:
ADM and SmartObjects

> ## 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:

> - Navigation operations — First, Prev, Next, Last. For information on these actions, see the "Navigation SmartPanels" section.

> - TableIO operations — Either of the following:

> - TableIO Save operations — Add record, Copy record, Delete record, Save record, Reset, Cancel.
> - TableIO Update operations — Add record, Update record, Copy record, Delete record, Save record, Reset, Cancel.

> For information on these actions, see the "Update SmartPanel" section.

> - Commit operations — Commit, Undo. For information on these actions, see the "Commit SmartPanel" section.

> - Filter operation — For information on this action, see the "Filtering records" section.

> 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:

> - You can choose to show either a menu or a toolbar or both.

> - You can choose to show a decorative border rectangle around the toolbar; the border includes dividers between icon groups.

> - You can specify which actions the application user can perform from the SmartToolbar.

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

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

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