INFO: Toolbar Button Behavior with Checked Buttons

ID: Q231893

The information in this article applies to:

Microsoft Win32 Software Development Kit (SDK), on platform(s):
- Microsoft Windows versions 95, 98
- Microsoft Windows NT 4.0
- Microsoft Windows 2000

SUMMARY

When adding TBSTYLE_CHECK buttons to a toolbar that uses one or more image lists to supply bitmaps, the actual image displayed may be different than what is expected. Selected style buttons do not follow the identical convention for determining the image list that will be used to paint the button, depending on the state the button is in currently, and which image lists are available.

MORE INFORMATION

The following table indicates which image list is used with a selected button when two or more types of image lists are being used:

Toolbar Style Button State Default Image List Disabled Image List Hotimage Image List Resulting Image

Default None X X Disabled Imagelist

Default TBSTATE_ENABLED X X Default Imagelist

Default TBSTATE_CHECKED X X Default Imagelist

Default TBSTATE_PRESSED X X Disabled Imagelist

Default TBSTATE_ENABLED|TBSTATE_PRESSED X X Default Imagelist

Default TBSTATE_ENABLED|TBSTATE_CHECKED X X Default Imagelist

Default None X X X Disabled Imagelist

Default TBSTATE_ENABLED X X X Default Imagelist

Default TBSTATE_CHECKED X X X Hotimage Imagelist

Default TBSTATE_PRESSED X X X Disabled Imagelist

Default TBSTATE_ENABLED|TBSTATE_PRESSED X X X Default Imagelist

Default TBSTATE_ENABLED|TBSTATE_CHECKED X X X Hotimage Imagelist

TBSTYLE_FLAT None X X Disabled Imagelist

TBSTYLE_FLAT TBSTATE_ENABLED X X Default Imagelist

TBSTYLE_FLAT TBSTATE_CHECKED X X Default Imagelist

TBSTYLE_FLAT TBSTATE_PRESSED X X Disabled Imagelist

TBSTYLE_FLAT TBSTATE_ENABLED|TBSTATE_PRESSED X X Default Imagelist

TBSTYLE_FLAT TBSTATE_ENABLED|TBSTATE_CHECKED X X Default Imagelist

TBSTYLE_FLAT None X X X Disabled Imagelist

TBSTYLE_FLAT TBSTATE_ENABLED X X X Default Imagelist

TBSTYLE_FLAT TBSTATE_CHECKED X X X Hotimage Imagelist

TBSTYLE_FLAT TBSTATE_PRESSED X X X Disabled Imagelist

TBSTYLE_FLAT TBSTATE_ENABLED|TBSTATE_PRESSED X X X Default Imagelist

TBSTYLE_FLAT TBSTATE_ENABLED|TBSTATE_CHECKED X X X Hotimage Imagelist

Toolbar Style	Button State	Default Image List	Disabled Image List	Hotimage Image List	Resulting Image
Default	None	X	X		Disabled Imagelist
Default	TBSTATE_ENABLED	X	X		Default Imagelist
Default	TBSTATE_CHECKED	X	X		Default Imagelist
Default	TBSTATE_PRESSED	X	X		Disabled Imagelist
Default	TBSTATE_ENABLED\|TBSTATE_PRESSED	X	X		Default Imagelist
Default	TBSTATE_ENABLED\|TBSTATE_CHECKED	X	X		Default Imagelist
Default	None	X	X	X	Disabled Imagelist
Default	TBSTATE_ENABLED	X	X	X	Default Imagelist
Default	TBSTATE_CHECKED	X	X	X	Hotimage Imagelist
Default	TBSTATE_PRESSED	X	X	X	Disabled Imagelist
Default	TBSTATE_ENABLED\|TBSTATE_PRESSED	X	X	X	Default Imagelist
Default	TBSTATE_ENABLED\|TBSTATE_CHECKED	X	X	X	Hotimage Imagelist
TBSTYLE_FLAT	None	X	X		Disabled Imagelist
TBSTYLE_FLAT	TBSTATE_ENABLED	X	X		Default Imagelist
TBSTYLE_FLAT	TBSTATE_CHECKED	X	X		Default Imagelist
TBSTYLE_FLAT	TBSTATE_PRESSED	X	X		Disabled Imagelist
TBSTYLE_FLAT	TBSTATE_ENABLED\|TBSTATE_PRESSED	X	X		Default Imagelist
TBSTYLE_FLAT	TBSTATE_ENABLED\|TBSTATE_CHECKED	X	X		Default Imagelist
TBSTYLE_FLAT	None	X	X	X	Disabled Imagelist
TBSTYLE_FLAT	TBSTATE_ENABLED	X	X	X	Default Imagelist
TBSTYLE_FLAT	TBSTATE_CHECKED	X	X	X	Hotimage Imagelist
TBSTYLE_FLAT	TBSTATE_PRESSED	X	X	X	Disabled Imagelist
TBSTYLE_FLAT	TBSTATE_ENABLED\|TBSTATE_PRESSED	X	X	X	Default Imagelist
TBSTYLE_FLAT	TBSTATE_ENABLED\|TBSTATE_CHECKED	X	X	X	Hotimage Imagelist

Additional query words:


Keywords          : kbNTOS400 kbWinOS2000 kbSDKWin32 kbToolbar kbGrpUser kbWinOS95 kbWinOS98 
Version           : WINDOWS:95,98
Platform          : WINDOWS 
Issue type        : kbinfo

Last Reviewed: June 4, 1999