CReBarCtrl

CObject
 └CCmdTarget
    └CWnd
       └CControlBar
          └CReBarCtrl


CReBarCtrl类封装了rebar控件的机能,rebar控件是一个子窗口容器。rebar控件所属的应用程序将rebar控件包含的子窗口分配给rebar带。子窗口是另外一种通用的控件。
rebar控件包含一个或多个带。每一个带可以包含一个控制条,一个位图,一个文本标签和一个子窗口的组合。但一个带只能包含每一种项的一个。
rebar控件可以在指定的位图之上显示子窗口。所有的rebar控件带都可以调整大小,除了那些使用RBBS_FIXEDSIZE风格的以外。当你调整一个rebar控件带的位置和大小的时候,rebar控件控制对应于该带的子窗口的位置和大小。单击和拖动一个带的控制条,就可以调整控件中的带的大小或改变它们的顺序。
下面的例子说明了一个具有三个带的rebar控件:
·带0包含了一个平坦的、透明(transparent)的工具条控件。
·带1包含了透明的标准按钮和下拉按钮。
·带2包含了一个组合框和四个标准按钮。



Rebar控件
·图像列表。
·消息处理。
·定制绘画功能。
·除标准的窗口风格之外,附加的各种控件风格。要获取这些风格的列表,参见“Platform SDK”中的“Rebar控件风格”。

#include <afxcmn.h>


CReBarCtrl类成员

构造
CReBarCtrl构造一个CReBarCtrl对象

初始化
Create创建rebar控件,并将它与CReBarCtrl对象连接

属性
GetBandCount获取在rebar控件中的当前带数
GetBandInfo获取rebar控件中的指定带的信息
SetBandInfo设置一个rebar控件中的已存在的带的特征
GetBarHeight获取rebar控件的高度
GetBarInfo获取有关rebar控件的信息以及它使用的图像列表
SetBarInfo设置一个rebar控件的特征
GetBkColor获取rebar控件的缺省背景颜色
SetBkColor设置一个rebar控件的缺省背景颜色
GetDropTarget获取一个rebar控件的IDropTarget接口指针
GetRect获取一个rebar控件中的给定带的边界矩形
GetRowCount获取一个rebar控件中的带行的数目
GetRowHeight获取一个rebar控件中的指定行的高度
GetTextColor获取一个rebar控件的缺省文本颜色
GetToolTips获取与rebar控件相关的任何工具提示控件的句柄
IDToIndex将一个带的标识符(ID)转换成一个rebar控件中的带索引
SetOwner设置一个rebar控件的属主窗口
SetTextColor设置一个rebar控件的缺省文本颜色
SetToolTips使一个工具提示控件与rebar控件相关联
GetImageList获取与rebar控件相关的图像列表
SetImageList设置一个rebar控件的图像列表
GetBandBorders获取一个带的边界
GetPalette获取rebar控件的当前调色板
SetPalette设置rebar控件的当前调色板

操作
BeginDrag设置rebar控件进入拖-放模式
DeleteBand从一个rebar控件中删除一个带
DragMove在调用BeginDrag后,更新在rebar控件中的拖动位置
EndDrag终止rebar控件的拖放操作
HitTest如果一个rebar带在屏幕上的给定点存在的话,则确定rebar带的哪一部分是在这个点上
InsertBand向一个rebar控件中插入一个新带
MaximizeBand将rebar控件中的一个带调整到它的理想或最大尺寸
MinimizeBand将rebar控件中的一个带调整到它的理想或最小尺寸
ShowBand显示或隐藏一个rebar控件中的给定带
SizeToRect使一个rebar控件符合一个指定的矩形
MoveBand将一个带从一个索引移动到另一个索引