Edit

Status Bar

  • Article

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.