通过

TBBUTTONINFOA 结构 （commctrl.h）

  • 项目

包含或接收工具栏中特定按钮的信息。

语法

typedef struct {
  UINT      cbSize;
  DWORD     dwMask;
  int       idCommand;
  int       iImage;
  BYTE      fsState;
  BYTE      fsStyle;
  WORD      cx;
  DWORD_PTR lParam;
  LPSTR     pszText;
  int       cchText;
} TBBUTTONINFOA, *LPTBBUTTONINFOA;

成员

cbSize

类型：UINT

结构的大小（以字节为单位）。 在发送关联消息之前，必须填写此成员。

dwMask

类型：DWORD

指示哪些成员包含有效信息的标志集。 在发送关联消息之前，必须填写此成员。 这可以是以下一个或多个值。

价值 意义
TBIF_BYINDEX

版本 5.80。 随 TB_GETBUTTONINFO 或 TB_SETBUTTONINFO 消息一起发送 wParam 是索引，而不是标识符。
TBIF_COMMAND
 idCommand 成员包含有效信息或正在请求。
TBIF_IMAGE
 iImage 成员包含有效信息或正在请求。
TBIF_LPARAM
 lParam 成员包含有效信息或正在请求。
TBIF_SIZE
 cx 成员包含有效信息或正在请求。
TBIF_STATE
 fsState 成员包含有效信息或正在请求。
TBIF_STYLE
 fsStyle 成员包含有效信息或正在请求。
TBIF_TEXT
 pszText 成员包含有效信息或正在请求。

idCommand

类型：int

按钮的命令标识符。

iImage

类型：int

按钮的图像索引。 将此成员设置为I_IMAGECALLBACK，工具栏将发送 TBN_GETDISPINFO 通知代码，以在需要时检索图像索引。

版本 5.81。 将此成员设置为I_IMAGENONE以指示按钮没有图像。 按钮布局不包括位图的任何空间，仅包含文本。

fsState

类型：BYTE

按钮的状态标志。 这可以是 工具栏按钮状态中列出的一个或多个值。

fsStyle

类型：BYTE

按钮的样式标志。 这可以是 工具栏控件和按钮样式中列出的一个或多个值。

cx

类型：WORD

按钮的宽度（以像素为单位）。

lParam

类型：DWORD_PTR

与按钮关联的应用程序定义值。

pszText

类型：LPTSTR

包含或接收按钮文本的字符缓冲区的地址。

cchText

类型：int

pszText处缓冲区的大小。 如果正在设置按钮信息，则忽略此成员。

言论

注意

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

要求

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