user manual

Appendix B: iTool Compound Widgets 411
iTool Developer’s Guide CW_ITTOOLBAR
CW_ITTOOLBAR
The CW_ITTOOLBAR function creates a toolbar base compound widget. The items
in the toolbar correspond to the operations or manipulators contained in a specified
container object within the OPERATIONS container of the associated iTool. (See
“iTool Object Hierarchy” on page 31 for a description of the iTool object hierarchy.)
Warning
This routine can only be used in the context of a user-created iTool. See “Overview
of iTools Compound Widgets” on page 398 for details.
The CW_ITTOOLBAR widget automatically performs the following actions:
1. For each item in the container, creates either a bitmap button or a
droplist/combobox:
• If the item was registered with the DROPLIST_ITEMS property set, a
droplist or combobox is created. If the DROPLIST_EDIT property is set
on the item, an editable combobox widget is included on the toolbar —
otherwise a droplist is included. The value of the DROPLIST_INDEX
property is used to select the initial value. The value of the DISABLE
property determines the initial sensitivity of the droplist or combobox. See
IDLitTool::RegisterOperation for details on using these properties.
• If the item was not registered with the DROPLIST_ITEMS property set, a
bitmap button is created. The value of the item’s ICON property is used
for the bitmap filename (or, if the ICON property is not set, the file
resource/bitmaps/new.bmp is used). The value of the DISABLE
property determines the initial sensitivity of the button. The value of the
NAME property is used for the button tooltip.
2. Registers itself with the specified user interface object.
3. Adds itself as an observer of the specified container. If any changes occur to
items within the container, then the toolbar will be notified and will