Структура TBBUTTON (commctrl.h)

  • Статья

Содержит сведения о кнопке на панели инструментов.

Синтаксис

typedef struct _TBBUTTON {
  int       iBitmap;
  int       idCommand;
  BYTE      fsState;
  BYTE      fsStyle;
#if ...
  BYTE      bReserved[6];
#else
  BYTE      bReserved[2];
#endif
  DWORD_PTR dwData;
  INT_PTR   iString;
} TBBUTTON, *PTBBUTTON, *LPTBBUTTON;

Члены

iBitmap

Тип: int

Отсчитываемый от нуля индекс изображения кнопки. Задайте для этого элемента значение I_IMAGECALLBACK, а панель инструментов отправит код уведомления TBN_GETDISPINFO , чтобы получить индекс изображения при необходимости.

Версия 5.81. Присвойте этому элементу значение I_IMAGENONE, чтобы указать, что у кнопки нет изображения. Макет кнопки не будет содержать пробелы для растрового изображения, а только текст.

Если кнопка является разделителем, то есть если параметр fsStyle имеет значение BTNS_SEP, iBitmap определяет ширину разделителя в пикселях. Сведения о выборе изображений кнопок из списков изображений см. в разделе TB_SETIMAGELIST сообщении.

idCommand

Тип: int

Идентификатор команды, связанный с кнопкой. Этот идентификатор используется в сообщении WM_COMMAND при нажатии кнопки.

fsState

Тип: BYTE

Флаги состояния кнопки. Этот элемент может быть сочетанием значений, перечисленных в разделе Состояния кнопки панели инструментов.

fsStyle

Тип: BYTE

Стиль кнопки. Этот элемент может быть сочетанием значений стиля кнопки, перечисленных в разделе Элементы управления панелью инструментов и Стили кнопок.

bReserved[6]

Тип: BYTE

Зарезервировано.

bReserved[2]

Тип: BYTE

Зарезервировано.

dwData

Тип: DWORD_PTR

Значение, определяемое приложением.

iString

Тип: INT_PTR

Отсчитываемый от нуля индекс строки кнопки или указатель на строковый буфер, содержащий текст для кнопки.

Комментарии

Элемент iString может возвращать строковый указатель или индекс. Для определения возвращаемого значения можно использовать макрос IS_INTRESOURCE .

Требования

Требование Значение
Минимальная версия клиента Windows Vista [только классические приложения]
Минимальная версия сервера Windows Server 2003 [только классические приложения]
Верхняя часть commctrl.h