mensaje de TTM_SETTITLE

Esta función se usa para agregar un icono y una cadena de título estándar a una información sobre herramientas.

Parámetros

wParam

Establezca wParam en uno de los valores siguientes para especificar el icono que se va a mostrar. A partir de Windows Vista y versiones posteriores, este parámetro también puede contener un valor HICON . Se supone que cualquier valor mayor que TTI_ERROR_LARGE es un HICON.

Valor	Significado
TTI_NONE	Sin icono.
TTI_INFO	Icono de información.
TTI_WARNING	Icono de advertencia
TTI_ERROR	Icono de error
TTI_INFO_LARGE	Icono de error grande
TTI_WARNING_LARGE	Icono de error grande
TTI_ERROR_LARGE	Icono de error grande

lParam

El valor de este parámetro se corresponde con un puntero que apunta a la cadena de título. Debe asignar un valor a lParam.

Valor devuelto

Devuelve TRUE si se ejecuta correctamente, FALSE si no es así.

Comentarios

El título de una información sobre herramientas aparece encima del texto, en una fuente diferente. No es suficiente tener un título; La información sobre herramientas también debe tener texto o no se muestra.

Cuando wParam contiene un HICON, la ventana de información sobre herramientas crea una copia del icono.

Al llamar a TTM_SETTITLE, la cadena a la que apunta lParam no debe superar los 100 TCHAR de longitud, incluida la terminación NULL.

Ejemplos

En el ejemplo siguiente se muestra cómo agregar un título y un icono del sistema a una información sobre herramientas.

// hwndTip is the handle of the tooltip window.
HICON hIcon = LoadIcon(NULL, IDI_INFORMATION);
SendMessage(hwndTip, TTM_SETTITLE, (WPARAM)hIcon, L"Title text");
DestroyIcon(hIcon);

Requisitos

Requisito	Valor
Cliente mínimo compatible	Windows Vista [solo aplicaciones de escritorio]
Servidor mínimo compatible	Windows Server 2003 [solo aplicaciones de escritorio]
Encabezado	Commctrl.h
Nombres Unicode y ANSI	TTM_SETTITLEW (Unicode) y TTM_SETTITLEA (ANSI)

Consulte también

Acerca de los controles de información sobre herramientas