Status Bar

This section contains information about the programming elements used with status bar controls.

Overviews

Topic	Contents
Status Bars	A status bar is a horizontal window at the bottom of a parent window in which an application can display various kinds of status information.

Functions

Topic	Contents
CreateStatusWindow	Creates a status window, which is typically used to display the status of an application. The window generally appears at the bottom of the parent window, and it contains the specified text. Note: This function is obsolete. Use CreateWindow instead.
DrawStatusText	The DrawStatusText function draws the specified text in the style of a status window with borders.
MenuHelp	Processes WM_MENUSELECT and WM_COMMAND messages and displays Help text about the current menu in the specified status window.

Messages

Topic	Contents
SB_GETBORDERS	Retrieves the current widths of the horizontal and vertical borders of a status window.
SB_GETICON	Retrieves the icon for a part in a status bar.
SB_GETPARTS	Retrieves a count of the parts in a status window. The message also retrieves the coordinate of the right edge of the specified number of parts.
SB_GETRECT	Retrieves the bounding rectangle of a part in a status window.
SB_GETTEXT	The SB_GETTEXT message retrieves the text from the specified part of a status window.
SB_GETTEXTLENGTH	The SB_GETTEXTLENGTH message retrieves the length, in characters, of the text from the specified part of a status window.
SB_GETTIPTEXT	Retrieves the tooltip text for a part in a status bar. The status bar must be created with the SBT_TOOLTIPS style to enable tooltips.
SB_GETUNICODEFORMAT	Retrieves the Unicode character format flag for the control.
SB_ISSIMPLE	Checks a status bar control to determine if it is in simple mode.
SB_SETBKCOLOR	Sets the background color in a status bar.
SB_SETICON	Sets the icon for a part in a status bar.
SB_SETMINHEIGHT	Sets the minimum height of a status window's drawing area.
SB_SETPARTS	Sets the number of parts in a status window and the coordinate of the right edge of each part.
SB_SETTEXT	The SB_SETTEXT message sets the text in the specified part of a status window.
SB_SETTIPTEXT	Sets the tooltip text for a part in a status bar. The status bar must have been created with the SBT_TOOLTIPS style to enable tooltips.
SB_SETUNICODEFORMAT	Sets the Unicode character format flag for the control. This message allows you to change the character set used by the control at run time rather than having to re-create the control.
SB_SIMPLE	Specifies whether a status window displays simple text or displays all window parts set by a previous SB_SETPARTS message.

Notifications

Topic	Contents
NM_CLICK (status bar)	Notifies the parent window of a status bar control that the user has clicked the left mouse button within the control. NM_CLICK (status bar) is sent in the form of a WM_NOTIFY message.
NM_DBLCLK (status bar)	Notifies the parent window of a status bar control that the user has double-clicked the left mouse button within the control. This notification is sent in the form of a WM_NOTIFY message.
NM_RCLICK (status bar)	Notifies the parent window of a status bar control that the user has clicked the right mouse button within the control. This notification is sent in the form of a WM_NOTIFY message.
NM_RDBLCLK (status bar)	Notifies the parent windows of a status bar control that the user has double-clicked the right mouse button within the control. NM_RDBLCLK (status bar) is sent in the form of a WM_NOTIFY message.
SBN_SIMPLEMODECHANGE	Sent by a status bar control when the simple mode changes due to a SB_SIMPLE message. This notification is sent in the form of a WM_NOTIFY message.

Constants

Topic	Contents
Status Bar Styles	This section lists the styles, in addition to standard window styles, supported by status bar controls.