Estructura TTTOOLINFOA (commctrl.h)
La estructura TOOLINFO contiene información sobre una herramienta en un control de información sobre herramientas.
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
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 |
---|---|
|
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. |
|
Centra la ventana de información sobre herramientas debajo de la herramienta especificada por el miembro uId. |
|
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. |
|
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. |
|
Indica que el texto de la información sobre herramientas se mostrará en la dirección opuesta al texto de la ventana primaria. |
|
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. |
|
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. |
|
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
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
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:
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.
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.
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 |