Estructura TTTOOLINFOA (commctrl.h)

La estructura TOOLINFO contiene información sobre una herramienta en un control de información sobre herramientas.

Sintaxis

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;

Miembros

cbSize

Tipo: UINT de

Tamaño de esta estructura, en bytes. Este miembro debe especificarse.

uFlags

Tipo: UINT de

Marcas que controlan la presentación de la información sobre herramientas. Este miembro puede ser una combinación de los siguientes valores:

Valor Significado
TTF_ABSOLUTE
Coloca la ventana de información sobre herramientas en las mismas coordenadas proporcionadas por TTM_TRACKPOSITION. Esta marca debe usarse con la marca TTF_TRACK.
TTF_CENTERTIP
Centra la ventana de información sobre herramientas debajo de la herramienta especificada por el miembro uId.
TTF_IDISHWND
Indica que el miembro uId es el identificador de ventana de la herramienta. Si no se establece esta marca, uId es el identificador de la herramienta.
TTF_PARSELINKS

versión 6.0 y posteriores. Indica que se deben analizar los vínculos del texto de información sobre herramientas.

Tenga en cuenta que Comctl32.dll versión 6 no es redistribuible, pero se incluye en Windows o versiones posteriores. Para usar Comctl32.dll versión 6, especifíquelo en un manifiesto. Para obtener más información sobre los manifiestos, vea Habilitación de estilos visuales.

TTF_RTLREADING
Indica que el texto de la información sobre herramientas se mostrará en la dirección opuesta al texto de la ventana primaria.
TTF_SUBCLASS
Indica que el control de información sobre herramientas debe subclase la ventana de la herramienta para interceptar mensajes, como WM_MOUSEMOVE. Si no se establece esta marca, debe usar el mensaje de TTM_RELAYEVENT para reenviar mensajes al control de información sobre herramientas. Para obtener una lista de mensajes que procesa una información sobre herramientas, consulte TTM_RELAYEVENT.
TTF_TRACK
Coloca la ventana de información sobre herramientas junto a la herramienta a la que corresponde y mueve la ventana según las coordenadas proporcionadas por los mensajes de TTM_TRACKPOSITION. Debe activar este tipo de herramienta mediante el mensaje TTM_TRACKACTIVATE.
TTF_TRANSPARENT
Hace que el control de información sobre herramientas reenvíe los mensajes de eventos del mouse a la ventana primaria. Esto se limita a los eventos del mouse que se producen dentro de los límites de la ventana de información sobre herramientas.

hwnd

Tipo: HWND

Identificador de la ventana que contiene la herramienta. Si lpszText incluye el valor LPSTR_TEXTCALLBACK, este miembro identifica la ventana que recibe los códigos de notificación de TTN_GETDISPINFO.

uId

Tipo: UINT_PTR

Identificador definido por la aplicación de la herramienta. Si uFlags incluye la marca de TTF_IDISHWND, uId debe especificar el identificador de ventana para la herramienta.

rect

Tipo: RECT

Coordenadas de rectángulo delimitador de la herramienta. Las coordenadas son relativas a la esquina superior izquierda del área cliente de la ventana identificada por hwnd. Si uFlags incluye la marca TTF_IDISHWND, se omite este miembro.

hinst

Tipo: HINSTANCE

Identificador de la instancia que contiene el recurso de cadena de la herramienta. Si lpszText especifica el identificador de un recurso de cadena, se usa este miembro.

lpszText

Tipo: LPTSTR de

Puntero al búfer que contiene el texto de la herramienta o identificador del recurso de cadena que contiene el texto. Este miembro se usa a veces para devolver valores. Si necesita examinar el valor devuelto, debe apuntar a un búfer válido de tamaño suficiente. De lo contrario, se puede establecer en NULL. Si lpszText está establecido en LPSTR_TEXTCALLBACK, el control envía el código de notificación TTN_GETDISPINFO a la ventana del propietario para recuperar el texto.

lParam

Tipo: LPARAM de

versión 4.70 y posteriores. Valor definido por la aplicación de 32 bits asociado a la herramienta.

lpReserved

Tipo: void*

Reservado. Debe establecerse en NULL.

Observaciones

Las ventanas normales muestran texto de izquierda a derecha (LTR). Windows se puede reflejado para mostrar idiomas como hebreo o árabe que leen de derecha a izquierda (RTL). Normalmente, el texto de la información sobre herramientas se muestra en la misma dirección que el texto de su ventana primaria. Si se establece TTF_RTLREADING, el texto de la información sobre herramientas leerá en la dirección opuesta del texto de la ventana primaria.

Nota

El encabezado commctrl.h define TTTOOLINFO como alias que selecciona automáticamente la versión ANSI o Unicode de esta función en función de la definición de la constante de preprocesador UNICODE. La combinación del uso del alias neutral de codificación con código que no es neutral de codificación puede dar lugar a errores de coincidencia que dan lugar a errores de compilación o tiempo de ejecución. Para obtener más información, vea Conventions for Function Prototypes.

Requisitos

Requisito Valor
cliente mínimo admitido Windows Vista [solo aplicaciones de escritorio]
servidor mínimo admitido Windows Server 2003 [solo aplicaciones de escritorio]
encabezado de commctrl.h