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

  • Статья

Структура TOOLINFO содержит сведения об инструменте в элементе управления подсказкой.

Синтаксис

typedef struct tagTOOLINFOA {
  UINT      cbSize;
  UINT      uFlags;
  HWND      hwnd;
  UINT_PTR  uId;
  RECT      rect;
  HINSTANCE hinst;
  LPSTR     lpszText;
  LPARAM    lParam;
  void      *lpReserved;
} TTTOOLINFOA, *PTOOLINFOA, *LPTTTOOLINFOA;

Члены

cbSize

Тип: UINT

Размер этой структуры в байтах. Этот элемент должен быть указан.

uFlags

Тип: UINT

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

Значение Значение
TTF_ABSOLUTE
 Располагает окно подсказки по тем же координатам, что и TTM_TRACKPOSITION. Этот флаг необходимо использовать с флагом TTF_TRACK.
TTF_CENTERTIP
 Центр окна подсказки под инструментом, заданным элементом uId .
TTF_IDISHWND
 Указывает, что элемент uId является дескриптором окна для средства. Если этот флаг не задан, uId является идентификатором средства.
TTF_PARSELINKS

Версия 6.0 и более поздняя. Указывает, что необходимо проанализировать ссылки в тексте подсказки.

Обратите внимание, что Comctl32.dll версии 6 не распространяется, но входит в состав Windows или более поздней версии. Чтобы использовать Comctl32.dll версии 6, укажите его в манифесте. Дополнительные сведения о манифестах см. в разделе Включение визуальных стилей.
TTF_RTLREADING
 Указывает, что текст подсказки будет отображаться в направлении, противоположном тексту в родительском окне.
TTF_SUBCLASS
 Указывает, что элемент управления подсказкой должен быть подкласс окна средства для перехвата сообщений, например WM_MOUSEMOVE. Если этот флаг не установлен, необходимо использовать сообщение TTM_RELAYEVENT для пересылки сообщений в элемент управления подсказки. Список сообщений, которые обрабатывает элемент управления подсказкой, см. в разделе TTM_RELAYEVENT.
TTF_TRACK
 Помещает окно подсказки рядом со средством, которому оно соответствует, и перемещает окно в соответствии с координатами, предоставленными TTM_TRACKPOSITION сообщениями. Этот тип средства необходимо активировать с помощью сообщения TTM_TRACKACTIVATE .
TTF_TRANSPARENT
 Заставляет элемент управления подсказками пересылать сообщения о событиях мыши в родительское окно. Это ограничивается событиями мыши, которые происходят в пределах окна подсказки.

hwnd

Тип: HWND

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

uId

Тип: UINT_PTR

Определяемый приложением идентификатор средства. Если uFlags содержит флаг TTF_IDISHWND, uId должен указать дескриптор окна для средства.

rect

Тип: RECT

Ограничивающие координаты прямоугольника инструмента. Координаты относятся к верхнему левому углу клиентской области окна, определяемой hwnd. Если uFlags содержит флаг TTF_IDISHWND, этот элемент игнорируется.

hinst

Тип: HINSTANCE

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

lpszText

Тип: LPTSTR

Указатель на буфер, содержащий текст для средства, или идентификатор строкового ресурса, содержащего текст. Этот элемент иногда используется для возврата значений. Если необходимо проверить возвращаемое значение, необходимо указать на допустимый буфер достаточного размера. В противном случае ему может быть присвоено значение NULL. Если для lpszText задано значение LPSTR_TEXTCALLBACK, элемент управления отправляет код уведомления TTN_GETDISPINFO в окно владельца для получения текста.

lParam

Тип: LPARAM

Версия 4.70 и более поздняя. 32-разрядное значение, определенное приложением, связанное со средством.

lpReserved

Тип: void*

Зарезервировано. Необходимо задать значение NULL.

Комментарии

Обычные окна отображают текст слева направо (LTR). Windows можно зеркально отображать на таких языках, как иврит или арабский, которые читают справа налево (RTL). Как правило, текст подсказки отображается в том же направлении, что и текст в родительском окне. Если задано TTF_RTLREADING, текст подсказки будет считываться в противоположном направлении от текста в родительском окне.

Примечание

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

Требования

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