REBARBANDINFOA 结构 (commctrl.h)

项目
02/24/2024

包含定义 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。带将始终具有大小抓地力，即使它是 rebar 中唯一的带。
RBBS_HIDDEN	该带将不可见。
RBBS_NOGRIPPER	版本 4.71。带永远不会有大小抓地力，即使 rebar 中有多个带。
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 指定背景位图，则忽略这些成员。默认情况下，带区将使用 rebar 控件集的背景色和 RB_SETBKCOLOR 消息。如果在此处指定了背景色，则将改用此背景色。

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

通过

REBARBANDINFOA 结构 (commctrl.h)

语法

成员

注解

要求

反馈

其他资源