commctrl.h

Mensaje TTM_SETTITLE

Definición

TTM_SETTITLE  
wParam = (WPARAM) (HICON) hIcon; 
lParam = (LPARAM) (LPSTR) szTitle;

El mensaje TTM_SETTITLE añade un icono estándar y un título a un tooltip.

Descripción

hIcon
Asignar a este parámetro uno de los siguientes valores para especificar el icono a mostrar. Desde la versión de Windows XP SP2, este parámetro puede también contener un valor HICON. Cualquier valor mayor que TTI_ERROR se asume que debe ser un HICON.
Valor Significado
TTI_NONE Sin icono.
TTI_INFO Icono de informacion.
TTI_WARNING Icono de aviso.
TTI_ERROR Icono de error.
TTI_INFO_LARGE Icono de información grande.
TTI_WARNING_LARGE Icono de aviso grande.
TTI_ERROR_LARGE Icono de error grande.
szTitle
Puntero a la cadena de título. Se debe asignar un valor a este parámetro.

Valor de retorno

Devuelve TRUE si tiene éxito, FALSE si no.

Observaciones

El título de un tooltip aparece debajo del texto, en una fuente diferente. No es suficiente que haya un título; el tooltip debe tener un texto también, o no se mostrará.

Cuando el parámetro hIcon contiene un HICON, la ventana tooltip crea una copia del icono.

Cuando se invoca a TTM_SETTITLE, la cadena apuntada por el parámetro szTitle no debe exceder de 100 TCHARs de longitud, incluyendo el terminador NULL.

Ejemplos

El ejemplo siguiente muestra como añadir un título y un icono de sistema a un tooltip.

// 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);