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