CStatusBarCtrl Class

Provides the functionality of the Windows common status bar control.

class CStatusBarCtrl : public CWnd

Members

Public Constructors

Name

Description

CStatusBarCtrl::CStatusBarCtrl

Constructs a CStatusBarCtrl object.

Public Methods

Name

Description

CStatusBarCtrl::Create

Creates a status bar control and attaches it to a CStatusBarCtrl object.

CStatusBarCtrl::CreateEx

Creates a status bar control with the specified Windows extended styles and attaches it to a CStatusBarCtrl object.

CStatusBarCtrl::DrawItem

Called when a visual aspect of an owner-draw status bar control changes.

CStatusBarCtrl::GetBorders

Retrieves the current widths of the horizontal and vertical borders of a status bar control.

CStatusBarCtrl::GetIcon

Retrieves the icon for a part (also known as a pane) in the current status bar control.

CStatusBarCtrl::GetParts

Retrieves a count of the parts in a status bar control.

CStatusBarCtrl::GetRect

Retrieves the bounding rectangle of a part in a status bar control.

CStatusBarCtrl::GetText

Retrieves the text from the given part of a status bar control.

CStatusBarCtrl::GetTextLength

Retrieve the length, in characters, of the text from the given part of a status bar control.

CStatusBarCtrl::GetTipText

Retrieves the tooltip text for a pane in a status bar.

CStatusBarCtrl::IsSimple

Checks a status window control to determine if it is in simple mode.

CStatusBarCtrl::SetBkColor

Sets the background color in a status bar.

CStatusBarCtrl::SetIcon

Sets the icon for a pane in a status bar.

CStatusBarCtrl::SetMinHeight

Sets the minimum height of a status bar control's drawing area.

CStatusBarCtrl::SetParts

Sets the number of parts in a status bar control and the coordinate of the right edge of each part.

CStatusBarCtrl::SetSimple

Specifies whether a status bar control displays simple text or displays all control parts set by a previous call to SetParts.

CStatusBarCtrl::SetText

Sets the text in the given part of a status bar control.

CStatusBarCtrl::SetTipText

Sets the tooltip text for a pane in a status bar.

Remarks

A "status bar control" is a horizontal window, usually displayed at the bottom of a parent window, in which an application can display various kinds of status information. The status bar control can be divided into parts to display more than one type of information.

This control (and therefore the CStatusBarCtrl class) is available only to programs running under Windows 95/98 and Windows NT version 3.51 and later.

For more information on using CStatusBarCtrl, see Controls and Using CStatusBarCtrl.

Inheritance Hierarchy

CObject

CCmdTarget

CWnd

CStatusBarCtrl

Requirements

Header: afxcmn.h

See Also

Reference

CWnd Class

Hierarchy Chart

CToolBarCtrl Class