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

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

uFlags

Tipo: UINT

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

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 la información sobre herramientas. Tenga en cuenta que Comctl32.dll versión 6 no es redistribuible, pero se incluye en Windows o posterior. Para usar Comctl32.dll versión 6, especifíquela 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 TTM_RELAYEVENT mensaje para reenviar mensajes al control de información sobre herramientas. Para obtener una lista de los mensajes que procesa un control de 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 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 TTN_GETDISPINFO .

uId

Tipo: UINT_PTR

Identificador definido por la aplicación de la herramienta. Si uFlags incluye la marca 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 de 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 para la herramienta. Si lpszText especifica el identificador de un recurso de cadena, se usa este miembro.

lpszText

Tipo: LPTSTR

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 se establece 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

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.

Comentarios

Las ventanas normales muestran texto de izquierda a derecha (LTR). Windows se puede reflejar 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 Convenciones para prototipos de función.

Requisitos

Requisito	Value
Cliente mínimo compatible	Windows Vista [solo aplicaciones de escritorio]
Servidor mínimo compatible	Windows Server 2003 [solo aplicaciones de escritorio]
Encabezado	commctrl.h