This section contains information about the programming elements used with status bar controls.
Overviews
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
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.
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
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
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 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
Status Bar Styles
This section lists the styles, in addition to standard window styles, supported by status bar controls.