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.

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

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 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.