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

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

Синтаксис

typedef struct tagNMLVGETINFOTIPW {
  NMHDR  hdr;
  DWORD  dwFlags;
  LPWSTR pszText;
  int    cchTextMax;
  int    iItem;
  int    iSubItem;
  LPARAM lParam;
} NMLVGETINFOTIPW, *LPNMLVGETINFOTIPW;

Члены

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