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

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

Синтаксис

typedef struct tagNMLVGETINFOTIPA {
  NMHDR  hdr;
  DWORD  dwFlags;
  LPSTR  pszText;
  int    cchTextMax;
  int    iItem;
  int    iSubItem;
  LPARAM lParam;
} NMLVGETINFOTIPA, *LPNMLVGETINFOTIPA;

Члены

hdr

Тип: NMHDR

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

dwFlags

Тип: DWORD

Либо ноль, либо LVGIT_UNFOLDED. См. заметки.

pszText

Тип: LPTSTR

Адрес строкового буфера, который получает любые дополнительные текстовые сведения. Если dwFlags равно нулю, этот элемент будет содержать существующий текст элемента. В этом случае следует добавить любой дополнительный текст в конец этой строки. Размер этого буфера определяется структурой cchTextMax .

cchTextMax

Тип: int

Размер буфера в символах, на который указывает pszText. Хотя никогда не следует предполагать, что этот буфер будет иметь определенный размер, значение INFOTIPSIZE можно использовать в целях проектирования.

iItem

Тип: int

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

iSubItem

Тип: int

Одноуровневый индекс подэлемента, на который ссылается эта структура. Если этот элемент равен нулю, структура ссылается на элемент, а не на подэлемент. Этот элемент в настоящее время не используется и всегда будет равен нулю.

lParam

Тип: LPARAM

Определяемое приложением значение, связанное с элементом. Этот элемент в настоящее время не используется и всегда будет равен нулю.

Комментарии

При усечении текущего текста элемент считается сложенным. Если LVGIT_UNFOLDED возвращается в dwFlags, полный текст элемента уже отображается, поэтому нет необходимости отображать его в подсказке.

Примечание

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

Требования

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