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

Структура 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
 Центрируется окно подсказки под инструментом, указанным элементом u Id.
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

Ограничивающие координаты прямоугольника средства. Координаты относятся к левому верхнему углу клиентской области окна, определяемой навесной. Если 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