CReBar

CReBar 对 象 是 一 个 控 制 条 ， 它 为 rebar 控 件 提 供 页 面 布 局 、 持 续 性 和 状 态 信 息 。

rebar 对 象 可 以 包 含 多 种 子 窗 口 ， 通 常 是 其 它 控 件 ， 包 括 编 辑 框 、 工 具 条 和 列 表

框 。 rebar 对 象 可 以 把 它 的 子 窗 口 显 示 在 一 个 指 定 的 位 图 上 面 。 应 用 程 序 可 以 自动 地 改 变 rebar 的 大 小 ， 或 者 是 用 户 通 过 单 击 或 拖 动 rebar 的 控 制 条 来 手 动 改 变它 的 大 小 。

Rebar 控 件

rebar 对 象 的 行 为 类 似 于 一 个 工 具 条 对 象 的 行 为 。 一 个 rebar 使 用 单 击 － 拖 动 机制 来 调 整 它 的 带 的 尺 寸 。 一 个 rebar 控 件 可 以 包 含 一 个 或 多 个 带 ， 每 一 个 带 可以 是 一 个 控 制 条 、 一 个 位 图 、 一 个 文 本 标 签 和 一 个 子 窗 口 的 任 意 组 合 。 但 是 ，

带 不 能 包 含 多 于 一 个 的 子 窗 口 。

CReBar 使 用 CReBarCtrl 类 来 提 供 它 的 实 现 。你 可 以 通 过 CReBarCtrl 来 访 问 rebar 控 件 ， 以 利 用 控 件 的 定 制 选 项 。 要 获 取 有 关 rebar 控 件 的 给 定 选 项 ， 请 参 见CReBarCtrl。

警 告 Rebar 和 rebar 控 件 对 象 不 支 持 MFC 固 定 控 制 条 。 如 果 调 用 了CReBar::EnableDocking ， 则 你 的 应 用 程 序 将 给 出 断 言 。

#include <afxext.h>

CReBar 类 成 员

Construction

Create 创 建 一 个 rebar 控 件 ， 并 将 它 连 接 到 CReBar 对 象上

Attribute s GetReBarCtrl 允 许 直 接 访 问 基 础 通 用 控 件

AddBar 将 一 个 带 添 加 到 一 个 rebar 中

成 员 函 数

CReBar::AddBar

BOOL AddBar( CWnd* pBar , LPCTSTR lpszText = NULL, CBitmap* pbmp = NULL,

DWORD dwStyle = RBBS_GRIPPERALWAYS | RBBS_FIXEDBMP );

BOOL AddBar( CWnd* pBa r , COLORREF clrFore , COLORREF clrBack , LPCTSTR pszText = NULL, DWORD dwStyle = RBBS_GRIPPERALWAYS );

返 回 值

如 果 成 功 则 返 回 非 零 值 ； 否 则 返 回 0 。

参 数

pBar

一 个 指 向 CWnd 对 象 的 指 针 ， 该 对 象 将 要 被 插 入 rebar 的 子 窗 口 。 被 引 用的 对 象 必 须 有 一 个 WS_CHILD 。

lpszText

一 个 指 向 字 符 串 的 指 针 ， 该 字 符 串 包 含 要 显 示 在 rebar 上 的 文 本 。 其 缺 省值 是 NULL 。 pszText 中 包 含 的 文 本 并 不 是 子 窗 口 的 一 部 分 ； 它 是 在 rebar 本 身 上 的 。

pbmp

一 个 指 向 CBitmap 对 象 的 指 针 ， 该 对 象 被 显 示 在 rebar 的 背 景 上 。 其 缺 省值 为 NULL 。

dwStyle

一 个 包 含 要 应 用 于 rebar 的 风 格 的 DWORD 。 参 见 W in32 结 构 中 的 fStyle

函 数 的 描 述 ， 可 以 获 得 有 关 带 风 格 的 完 整 列 表 。

clrFore

一个 COLORREF 值 ， 它 代 表 了 rebar 的 前 景 颜 色 。

clrBack

一个 COLORREF 值 ， 它 代 表 了 rebar 的 背 景 颜 色 。

说 明

此 成 员 函 数 用 来 给 rebar 添 加 一 个 带 。

请 参 阅 CReBarCtrl

CReBar::Create

BOOL Create( CWnd* pParentWnd , DWORD dwCtrlStyle = RBS_BANDBORDERS,

DWORD dwStyle = WS_CHILD | WS_VISIBLE | WS_CLIPSIBLINGS |

WS_CLIPCHILDREN | CBRS_TOP, UINT nID = AFX_IDW_REBAR );

返 回 值

如 果 成 功 则 返 回 非 零 值 ； 否 则 返 回 0 。

参 数

pParentWnd

指 向 CWnd 对 象 的 指 针 ， 该 对 象 的 W indows 窗 口 是 状 态 条 的 父 窗 口 。 通常 是 你 的 框 架 窗 口 。

dwCtrlStyle

rebar 控 件 风 格 。 缺 省 的 ， 是 RBS_BANDBORDER S ， 这 种 风 格 显 示 窄 线来 分 隔 rebar 控 件 中 相 邻 的 带 。 参 见 “ Platform SDK” 中 的 “ Rebar 控件风 格 ” ， 可 以 获 得 一 个 风 格 列 表 。

dwStyle

rebar 窗 口 风 格 。

nID

rebar 的 子 窗 口 ID 。

说 明

此 成 员 函 数 用 来 创 建 一 个 reba r。

请 参 阅 CReBarCtrl

CReBar::GetReBarCtrl CReBarCtrl& GetReBarCtrl() const; 返 回 值

• 个 指 向 一 个 CReBarCtrl 对 象 的 引 用 。

说 明

此 成 员 函 数 允 许 直 接 访 问 基 础 通 用 控 件 。

调 用 此 成 员 函 数 来 利 用 W indows rebar 通 用 控 件 的 机 能 来 定 制 你 的 reba r。 当 你调 用 GetReBarCtrl 时 ， 它 返 回 一 个 指 向 CReBarCtrl 对 象 的 引 用 ， 这 样 你 就 可 以使 用 任 何 一 套 成 员 函 数 。

如 果 要 获 取 更 多 有 关 使 用 CReBarCtrl 来 定 制 你 的 rebar 的 信 息 ， 请 参 见“ V isual C++ 程 序 员 指 南 ” 中 的 “ 使 用 CReBarCtrl” 。