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

Структура 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 включенной структуры NMH DR.

Ценность Значение
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