Структура 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. WParam, отправленный с TB_GETBUTTONINFO или TB_SETBUTTONINFO сообщением, является индексом, а не идентификатором.
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 в качестве псевдонима, который автоматически выбирает версию ANSI или Юникод этой функции на основе определения константы препроцессора ЮНИКОД. Сочетание использования псевдонима, не зависящий от кодировки, с кодом, не зависящим от кодировки, может привести к несоответствиям, которые приводят к ошибкам компиляции или среды выполнения. Дополнительные сведения см. в разделе Соглашения для прототипов функций.

Требования

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