LBUTTONINFO

Summary

Contains information about a button associated with a tool in a toolbar.

Syntax

typedef struct _LBUTTONINFO 
{ 
   L_UINT uStructSize; 
   L_UINT uID; 
   L_UCHAR fsState; 
   HBITMAP hBitmap; 
   L_TCHAR szToolTipText [ TOOLBAR_TOOLTIP_MAX_TEXT ]; 
   L_UINT32 dwTag; 
} LBUTTONINFO, *pLBUTTONINFO; 

Members

uStructSize

Size of this structure.

uID

Command identifier associated with the button. This identifier will be used in the user specified callback to identify the button that initiated the call. Possible values for enum TOOLBARBUTTONID are:

fsState

Button state flags. This member can be a combination of the values listed below:

hBitmap

A DDB (device dependent bitmap) that will represent the Cold (enabled) bitmap of the button. The toolbar will automatically create the hot and the disabled bitmaps.

szToolTipText

A null-terminated array of characters that will become the button tool tip. The maximum length of this string is TOOLBAR_TOOLTIP_MAX_TEXT.

dwTag

User-defined data associated with the button information.

Comments

A toolbar is made up of one or more tools. The LTOOLBARINFO structure contains information about the toolbar in general. Information about each tool that makes up the toolbar is contained in an LTOOLBARINFO structure. Each tool in a toolbar may have one or more buttons associated with it. A tool with more than one button associated with it is said to be a sub-toolbar. Information about the button(s) associated with a tool in the toolbar is contained in one or more LBUTTONINFO structures.

Buttons on a toolbar may have the same ID number. If a function is called that uses a button ID, such as L_TBAddButton, then the toolkit function will act on the first button found with the specified ID.

Usage

Data Types

• LTOOLBARTOOL

Functions

• L_TBAddButton
• L_TBGetButtonInfo
• L_TBSetButtonInfo