Share via

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

  • Статья

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

Синтаксис

typedef struct {
  UINT      cbSize;
  DWORD     dwMask;
  int       idCommand;
  int       iImage;
  BYTE      fsState;
  BYTE      fsStyle;
  WORD      cx;
  DWORD_PTR lParam;
  LPWSTR    pszText;
  int       cchText;
} TBBUTTONINFOW, *LPTBBUTTONINFOW;

Члены

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