Tool Bar Item

This document covers the following topics:


Description

A tool bar item is an item inside a tool bar. A tool bar item is similar to a push button with a bitmap displayed on it. In most cases, a tool bar item will serve as an alias for a menu item. So, instead of programming again the same click-event handler code as for the menu item, you can use the tool bar item's SAME-AS attribute and assign the corresponding menu item handle value. If the tool bar item is clicked, the event handler of the corresponding menu item is triggered. If you do not use the SAME-AS attribute, you must specify the event handler code with the tool bar item.

You can determine the size of the tool bar items using the parent tool bar's ITEM-W and ITEM-H attributes.

Note:
For performance reasons, you should not use more than 16 colors in tool bar icon bitmaps; all bitmaps should share the same palette of colors.

Attributes for Tool Bar Item

Attribute Name Query Set/Modify In Attr. Window
ACCELERATOR X X/X X
BACKGROUND-COLOUR-NAME X X/X X
BACKGROUND-COLOUR-VALUE X X/X X
BITMAP-FILE-NAME X X/X X
CHECKED X X/X X
CLIENT-DATA X X/X  
CLIENT-HANDLE X X/X  
CLIENT-KEY X X/X  
CLIENT-VALUE X X/X  
DIL-TEXT X X/X X
ENABLED X X/X X
FIRST-CHILD X -/-  
LAST-CHILD X -/-  
MENU-ITEM-TYPE X X/- X
PARENT X X/-  
PREDECESSOR X -/-  
SAME-AS X X/X X
SHARED X X/X X
STYLE X X/- X
SUCCESSOR X X/-  
TOOLTIP X X/X X
TYPE X X/-  
VISIBLE X X/X X

Events

Click Event.