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

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

fStyle

类型：UINT

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

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 是水平度量。

要求