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

  • Статья

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

Синтаксис

typedef struct {
  NMHDR     hdr;
  DWORD     dwMask;
  int       idCommand;
  DWORD_PTR lParam;
  int       iImage;
  LPSTR     pszText;
  int       cchText;
} NMTBDISPINFOA, *LPNMTBDISPINFOA;

Члены

hdr

Тип: NMHDR

Структура NMHDR, содержащая дополнительные сведения об уведомлении.

dwMask

Тип: DWORD

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

Значение Значение
TBNF_IMAGE
 Запрашивается индекс изображения элемента. Индекс изображения должен быть помещен в элемент iImage .
TBNF_TEXT
 В настоящий момент не реализовано.
TBNF_DI_SETITEM
 Установите этот флаг при обработке TBN_GETDISPINFO; Элемент управления панели инструментов сохранит предоставленные сведения и больше не будет запрашивать их.

idCommand

Тип: int

Идентификатор команды элемента, для которого запрашивается отображаемая информация. Этот элемент заполняется элементом управления перед отправкой кода уведомления.

lParam

Тип: DWORD_PTR

Определяемое приложением значение, связанное с элементом, для которого запрашивается отображаемая информация. Этот элемент заполняется элементом управления перед отправкой кода уведомления.

iImage

Тип: int

Индекс изображения для элемента.

pszText

Тип: LPTSTR

Указатель на буфер символов, который получает текст элемента.

cchText

Тип: int

Размер буфера pszText в символах.

Комментарии

Примечание

Заголовок commctrl.h определяет NMTBDISPINFO в качестве псевдонима, который автоматически выбирает версию ANSI или Юникод этой функции на основе определения константы препроцессора ЮНИКОД. Использование псевдонима, не зависящий от кодирования, с кодом, который не является нейтральным для кодировки, может привести к несоответствиям, которые приводят к ошибкам компиляции или времени выполнения. Дополнительные сведения см. в разделе Соглашения для прототипов функций.

Требования

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