mensaje de TTM_ADJUSTRECT

Calcula el rectángulo de presentación de texto de un control de información sobre herramientas a partir de su rectángulo de ventana de ventana de información sobre herramientas o el rectángulo de la ventana de información sobre herramientas necesario para mostrar un rectángulo de presentación de texto especificado.

Parámetros

wParam

Valor que especifica la operación que se va a realizar. Si es TRUE, lParam se usa para especificar un rectángulo de presentación de texto y recibe el rectángulo de ventana correspondiente. Si es FALSE, lParam se usa para especificar un rectángulo de ventana y recibe el rectángulo de presentación de texto correspondiente.

lParam

Estructura RECT que contiene un rectángulo de ventana de información sobre herramientas o un rectángulo de presentación de texto.

Valor devuelto

Devuelve un valor distinto de cero si el rectángulo se ajusta correctamente y devuelve cero si se produce un error.

Comentarios

Este mensaje es especialmente útil cuando se desea usar un control de información sobre herramientas para mostrar el texto completo de una cadena que normalmente se trunca. Se usa normalmente con controles listview y treeview. Normalmente, este mensaje se envía en respuesta a un código de notificación de TTN_SHOW para que pueda colocar correctamente el control de información sobre herramientas.

El rectángulo de la ventana de información sobre herramientas es algo mayor que el rectángulo de presentación de texto que enlaza la cadena de información sobre herramientas. El origen de la ventana también se desplaza hacia arriba y hacia la izquierda desde el origen del rectángulo para mostrar texto. Para colocar el rectángulo de presentación de texto, debe calcular el rectángulo de ventana correspondiente y usar ese rectángulo para colocar la información sobre herramientas. TTM_ADJUSTRECT controla este cálculo.

Si establece wParam en TRUE, TTM_ADJUSTRECT toma el tamaño y la posición del rectángulo de presentación de texto de información sobre herramientas deseado y pasa el tamaño y la posición de la ventana de información sobre herramientas necesaria para mostrar el texto en la posición especificada. Si establece wParam en FALSE, puede especificar un rectángulo de ventana de información sobre herramientas y TTM_ADJUSTRECT devolverá el tamaño y la posición de su rectángulo de texto.

En el fragmento de código siguiente se muestra el uso del mensaje de TTM_ADJUSTRECT para colocar un control de información sobre herramientas para mostrar el texto completo de la cadena de un control en lugar de una cadena truncada. La función GetMyItemRect definida por la aplicación devuelve el rectángulo de texto que será necesario para mostrar el texto de la información sobre herramientas directamente sobre la cadena truncada. Los detalles de cómo se implementa esta función dependerán del control determinado. TTM_ADJUSTRECT se usa para enviar este rectángulo de texto al control de información sobre herramientas. Devuelve un rectángulo de ventana de tamaño adecuado y colocado que, a continuación, se usa para colocar la ventana de información sobre herramientas.

case TTN_SHOW:

if (MyStringIsTruncated) {
    RECT rc;
    
    GetMyItemRect(&rc);
    SendMessage(hwndToolTip, TTM_ADJUSTRECT, TRUE, (LPARAM)&rc);
    SetWindowPos(hwndToolTip,
                 NULL,
                 rc.left, rc.top,
                 0, 0,
                 SWP_NOSIZE|SWP_NOZORDER|SWP_NOACTIVATE);
} 

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