通过

REBARBANDINFOA 结构 （commctrl.h）

  • 项目

包含定义 rebar 控件中的带的信息。

语法

typedef struct tagREBARBANDINFOA {
  UINT     cbSize;
  UINT     fMask;
  UINT     fStyle;
  COLORREF clrFore;
  COLORREF clrBack;
  LPSTR    lpText;
  UINT     cch;
  int      iImage;
  HWND     hwndChild;
  UINT     cxMinChild;
  UINT     cyMinChild;
  UINT     cx;
  HBITMAP  hbmBack;
  UINT     wID;
  UINT     cyChild;
  UINT     cyMaxChild;
  UINT     cyIntegral;
  UINT     cxIdeal;
  LPARAM   lParam;
  UINT     cxHeader;
  RECT     rcChevronLocation;
  UINT     uChevronState;
} REBARBANDINFOA, *LPREBARBANDINFOA;

成员

cbSize

类型：UINT

此结构的大小（以字节为单位）。 应用程序必须在发送使用此结构地址作为参数的任何消息之前填充此成员。

fMask

类型：UINT

指示此结构的成员有效或必须填充的标志。 此值可以是以下内容的组合：

价值 意义
RBBIM_BACKGROUND
 hbmBack 成员有效或必须设置。
RBBIM_CHILD
 hwndChild 成员有效或必须设置。
RBBIM_CHILDSIZE
 cxMinChild、cyMinChild、cyChild、cyMaxChild，cyIntegral 成员有效或必须设置。
RBBIM_COLORS
 clrFore 和 clrBack 成员有效或必须设置。
RBBIM_HEADERSIZE

版本 4.71。 cxHeader 成员有效或必须设置。
RBBIM_IDEALSIZE

版本 4.71。 cxIdeal 成员有效或必须设置。
RBBIM_ID
 wID 成员有效或必须设置。
RBBIM_IMAGE
 iImage 成员有效或必须设置。
RBBIM_LPARAM

版本 4.71。 lParam 成员有效或必须设置。
RBBIM_SIZE
 cx 成员有效或必须设置。
RBBIM_STYLE
 fStyle 成员有效或必须设置。
RBBIM_TEXT
 lpText 成员有效或必须设置。
RBBIM_CHEVRONLOCATION
 rcChevronLocation 成员有效或必须设置。
RBBIM_CHEVRONSTATE
 uChevronState 成员有效或必须设置。

fStyle

类型：UINT

指定带形样式的标志。 此值可以是以下内容的组合：

价值 意义
RBBS_BREAK
 乐队位于一条新线上。
RBBS_CHILDEDGE
 该带在子窗口的顶部和底部有一个边缘。
RBBS_FIXEDBMP
 调整带大小时，背景位图不会移动。
RBBS_FIXEDSIZE
 无法调整带的大小。 使用此样式，大小控制不显示在乐队上。
RBBS_GRIPPERALWAYS

版本 4.71。 乐队将始终具有大小控制力，即使它是钢筋中唯一的带子。
RBBS_HIDDEN
 该带将不可见。
RBBS_NOGRIPPER

版本 4.71。 即使钢筋中有多个带子，乐队也不会有大小控制力。
RBBS_USECHEVRON

版本 5.80。 如果带小于 cxIdeal，则显示 V 形按钮。
RBBS_VARIABLEHEIGHT

版本 4.71。 条带可以由 rebar 控件调整大小;cyIntegral 和 cyMaxChild 影响 rebar 大小调整带的大小。
RBBS_NOVERT
 垂直时不显示。
RBBS_HIDETITLE
 保持带状标题隐藏。
RBBS_TOPALIGN
 将带保留在顶部行中。

clrFore

类型：COLORREF

带前景色。

clrBack

类型：COLORREF

带状背景色。 如果 hbmBack 指定背景位图，则忽略这些成员。 默认情况下，带区将使用与 RB_SETBKCOLOR 消息一起设置的 rebar 控件的背景色。 如果在此处指定了背景色，则将改用此背景色。

lpText

类型：LPTSTR

指向包含带的显示文本的缓冲区的指针。 如果从控件请求带信息，并在 fMask中指定了RBBIM_TEXT，则必须将此成员初始化为将接收文本的缓冲区的地址。

cch

类型：UINT

lpText处缓冲区的大小（以字节为单位）。 如果未从控件请求信息，则忽略此成员。

iImage

类型：int

应在带中显示的任何图像的从零开始的索引。 映像列表是使用 RB_SETBARINFO 消息设置的。

hwndChild

类型：HWND

乐队中包含的子窗口的句柄（如果有）。

cxMinChild

类型：UINT

子窗口的最小宽度（以像素为单位）。 带的大小不能小于此值。

cyMinChild

类型：UINT

子窗口的最小高度（以像素为单位）。 带的大小不能小于此值。

cx

类型：UINT

带的长度（以像素为单位）。

hbmBack

类型：HBITMAP

用作此带背景的位图的句柄。

wID

类型：UINT

控件用于标识自定义绘图通知消息的此带的 UINT 值。

cyChild

类型：UINT

版本 4.71。 带的初始高度（以像素为单位）。 除非指定RBBS_VARIABLEHEIGHT样式，否则将忽略此成员。

cyMaxChild

类型：UINT

版本 4.71。 带的最大高度（以像素为单位）。 除非指定RBBS_VARIABLEHEIGHT样式，否则将忽略此成员。

cyIntegral

类型：UINT

版本 4.71。 带可以增长或收缩的分步值（以像素为单位）。 如果调整了带的大小，则会按此值指定的步骤调整其大小。 除非指定RBBS_VARIABLEHEIGHT样式，否则将忽略此成员。

cxIdeal

类型：UINT

版本 4.71。 带的理想宽度（以像素为单位）。 如果条带最大化到理想的宽度（见 RB_MAXIMIZEBAND），则 rebar 控件将尝试使带段成为此宽度。

lParam

类型：LPARAM

版本 4.71。 应用程序定义的值。

cxHeader

类型：UINT

版本 4.71。 带头的大小（以像素为单位）。 带头是带边缘和子窗口边缘之间的区域。 这是显示带状文本和图像的区域（如果指定）。 如果指定此值，它将替代控件为带计算的普通标头维度。

rcChevronLocation

类型：RECT

版本 6。 V 形的位置。

uChevronState

类型：UINT

版本 6。 对象状态常量的组合。

言论

cxMinChild、cyMinChild，cx 成员提供有关控件方向的维度的信息。 也就是说，对于水平 rebar 控件，cxMinChild，cx 是水平度量，cyMinChild 是垂直度量。 但是，如果控件使用 CCS_VERT 样式，cxMinChild，cx 是垂直度量值，cyMinChild 是水平度量。

注意

commctrl.h 标头将 REBARBANDINFO 定义为一个别名，该别名根据 UNICODE 预处理器常量的定义自动选择此函数的 ANSI 或 Unicode 版本。 将中性编码别名与不中性编码的代码混合使用可能会导致编译或运行时错误不匹配。 有关详细信息，请参阅函数原型的 约定。

要求

要求 价值
最低支持的客户端 Windows Vista [仅限桌面应用]
支持的最低服务器 Windows Server 2003 [仅限桌面应用]
标头 commctrl.h