Поделиться через

Структура 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