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

  • Статья

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

Синтаксис

typedef struct tagNMTTDISPINFOA {
  NMHDR     hdr;
  LPSTR     lpszText;
  char      szText[80];
  HINSTANCE hinst;
  UINT      uFlags;
  LPARAM    lParam;
} NMTTDISPINFOA, *LPNMTTDISPINFOA;

Члены

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