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

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

  • Статья

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

Синтаксис

typedef struct tagNMHDDISPINFOA {
  NMHDR  hdr;
  int    iItem;
  UINT   mask;
  LPSTR  pszText;
  int    cchTextMax;
  int    iImage;
  LPARAM lParam;
} NMHDDISPINFOA, *LPNMHDDISPINFOA;

Члены

hdr

Тип: NMHDR

структуре NMHDR, содержащей сведения об этом коде уведомлений.

iItem

Тип: int

Отсчитываемый от нуля индекс элемента в элементе управления заголовком.

mask

Тип: UINT

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

Ценность Значение
HDI_TEXT
 Поле pszText должно быть заполнено.
HDI_IMAGE

версии 4.70. Поле iImage должно быть заполнено.
HDI_LPARAM
 Поле lParam должно быть заполнено.
HDI_DI_SETITEM

версии 4.70. Возвращаемое значение. Указывает, что элемент управления заголовком должен хранить сведения об элементе и не запрашивать его снова.

pszText

Тип: LPTSTR

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

cchTextMax

Тип: int

Размер буфера, на который pszText указывает.

iImage

Тип: int

Отсчитываемый от нуля индекс изображения в списке изображений. Указанное изображение будет отображаться с элементом заголовка, но оно не занимает место растрового изображения элемента. Если iImage задано значение I_IMAGECALLBACK, элемент управления запрашивает сведения об изображении для этого элемента с помощью кода уведомления HDN_GETDISPINFO.

lParam

Тип: LPARAM

Определяемое приложением значение для связывания с элементом.

Замечания

Заметка

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

Требования

Требование Ценность
минимальные поддерживаемые клиентские Windows Vista [только классические приложения]
минимальный поддерживаемый сервер Windows Server 2003 [только классические приложения]
заголовка commctrl.h