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

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

  • Статья

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

Синтаксис

typedef struct tagNMTTDISPINFOW {
  NMHDR     hdr;
  LPWSTR    lpszText;
  WCHAR     szText[80];
  HINSTANCE hinst;
  UINT      uFlags;
  LPARAM    lParam;
} NMTTDISPINFOW, *LPNMTTDISPINFOW;

Члены

hdr

Тип: NMHDR

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

lpszText

Тип: LPTSTR

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

szText[80]

Тип: TCHAR

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

hinst

Тип: HINSTANCE

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

uFlags

Тип: UINT

Флаги, указывающие, как интерпретировать элемент idFrom включенной структуры NMHDR .

Значение Значение
TTF_IDISHWND
 Если этот флаг установлен, idFrom является дескриптором средства. В противном случае это идентификатор средства.
TTF_RTLREADING
 Windows можно зеркально отображать на таких языках, как иврит или арабский язык, которые читают справа налево (RTL). Обычно текст подсказки считывается в том же направлении, что и текст в родительском окне. Чтобы подсказка считывала в направлении, противоположном родительскому окну, добавьте флаг TTF_RTLREADING в элемент uFlags при обработке уведомления.
TTF_DI_SETITEM

Версия 4.70. Если вы добавите этот флаг в uFlags во время обработки уведомления, элемент управления подсказкой сохранит предоставленные сведения и не будет запрашивать их снова.

lParam

Тип: LPARAM

Версия 4.70. Определяемые приложением данные, связанные со средством.

Комментарии

Необходимо указать массив lpszText на собственный частный буфер, если длина текста, используемого в подсказке, превышает 80 TCHAR. Система автоматически удаляет значения TCHAR ускорителя амперсанда (&) из всех строк, передаваемых в элемент управления подсказкой, если элемент управления не имеет TTS_NOPREFIX стиле.

Примечание

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

Требования

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