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