CStatusBar选件类

与文本输出窗格或“指示符行的控件条”。

class CStatusBar : public CControlBar

成员

fha3tfk7.collapse_all(zh-cn,VS.110).gif公共构造函数

名称

说明

CStatusBar::CStatusBar

构造 CStatusBar 对象。

fha3tfk7.collapse_all(zh-cn,VS.110).gif公共方法

名称

说明

CStatusBar::CommandToIndex

获取给定指示符ID.的索引

CStatusBar::Create

创建状态栏,附加到 CStatusBar 对象,并将初始字体和条高度。

CStatusBar::CreateEx

使用嵌入 CStatusBarCtrl 对象的附加样式创建一 CStatusBar 对象。

CStatusBar::DrawItem

调用,当所有者描述状态栏控件中的可视方面是。

CStatusBar::GetItemID

获取给定索引的指示符ID。

CStatusBar::GetItemRect

获取给定索引的显示矩形。

CStatusBar::GetPaneInfo

获取指示ID、样式和宽度给定索引处开始的。

CStatusBar::GetPaneStyle

获取给定索引的指示符样式。

CStatusBar::GetPaneText

获取给定索引的指示符文本。

CStatusBar::GetStatusBarCtrl

允许直接访问基础公共控件。

CStatusBar::SetIndicators

设置指示符ID。

CStatusBar::SetPaneInfo

设置指示符ID、样式和宽度给定索引处开始的。

CStatusBar::SetPaneStyle

为特定的索引的指示符样式。

CStatusBar::SetPaneText

为特定的索引的指示符文本。

备注

输出窗格通常用作消息行并将状态指示。 示例包括简要说明选定的菜单命令和指示器scroll lock、num LOCK和其他键的状态的菜单帮助消息行。

CStatusBar::GetStatusBarCtrl,成员函数新MFC 4.0,使您可以利用公共控件为状态栏自定义项和附加功能以支持的Windows。 CStatusBar 成员函数最提供了Windows公共控件的功能;但是,那么,当您调用 GetStatusBarCtrl时,可以为状态栏Windows 95的特性/98状态栏。 当您调用 GetStatusBarCtrl,它将返回对 CStatusBarCtrl 对象。 使用Windows公共控件,请参见 CStatusBarCtrl 有关设计工具栏的更多信息。 有关公共控件的信息,请参见 Windows SDK的 公共控件

框架在具有最左侧的指示符的数组存储指示符信息在位置0。 当您创建状态栏时,您使用数组框架与对应的指示的字符串ID。 然后可以使用字符串ID或索引访问指示符。

默认情况下,第一个指示符为“弹性”:其占据其他指示符窗格未使用的状态栏长度,因此,其他窗格是右对齐的。

若要创建状态栏,请执行以下步骤:

  1. 构造 CStatusBar 对象。

  2. 调用 创建 (或 CreateEx)函数创建状态栏窗口并将其附加到 CStatusBar 对象。

  3. 调用 SetIndicators 关联字符串ID与每个指示符。

可通过三种方式更新在状态栏窗格的文本:

  1. 调用 CWnd::SetWindowText 仅更新在窗格0 "的文本。

  2. 调用在状态栏中 ON_UPDATE_COMMAND_UI 处理程序的 CCmdUI::SetText

  3. 调用 SetPaneText 更新所有窗格的文本。

调用 SetPaneStyle 更新状态栏窗格的样式。

有关使用 CStatusBar的更多信息,请参见文章 MFC中的状态栏实现技术说明31:控制条

继承层次结构

CObject

CCmdTarget

CWnd

CControlBar

CStatusBar

要求

Header: afxext.h

请参见

参考

CControlBar选件类

层次结构图

CStatusBarCtrl选件类

CControlBar选件类

CWnd::SetWindowText

CStatusBar::SetIndicators

概念

MFC示例CTRLBARS

MFC DLGCBR32示例