Share via

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