messaggio di TTM_SETTITLE

  • Articolo

Aggiunge un'icona standard e una stringa di titolo a una descrizione comando.

Parametri

wParam

Impostare wParam su uno dei valori seguenti per specificare l'icona da visualizzare. A partire da Windows Vista e versioni successive, questo parametro può contenere anche un valore HICON . Qualsiasi valore maggiore di TTI_ERROR_LARGE viene considerato un HICON.

Valore Significato
TTI_NONE
 Nessuna icona.
TTI_INFO
 Icona Informazioni.
TTI_WARNING
 Icona avviso
TTI_ERROR
 Icona errore
TTI_INFO_LARGE
 Icona errore di grandi dimensioni
TTI_WARNING_LARGE
 Icona errore di grandi dimensioni
TTI_ERROR_LARGE
 Icona errore di grandi dimensioni

lParam

Puntatore alla stringa del titolo. È necessario assegnare un valore a lParam.

Valore restituito

Restituisce TRUE se l'operazione ha esito positivo, FALSE in caso contrario.

Commenti

Il titolo di una descrizione comando viene visualizzato sopra il testo, in un tipo di carattere diverso. Non è sufficiente avere un titolo; Anche la descrizione comando deve contenere testo o non viene visualizzata.

Quando wParam contiene un HICON, viene creata una copia dell'icona dalla finestra della descrizione comando.

Quando si chiama TTM_SETTITLE, la stringa a cui punta lParam non deve superare 100 TCHAR , inclusa la terminazione NULL.

Esempio

Nell'esempio seguente viene illustrato come aggiungere un titolo e un'icona di sistema a una descrizione comando.

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

Requisiti

Requisito Valore
Client minimo supportato
 Windows Vista [solo app desktop]
Server minimo supportato
 Windows Server 2003 [solo app desktop]
Intestazione
Commctrl.h
Nomi Unicode e ANSI
 TTM_SETTITLEW (Unicode) e TTM_SETTITLEA (ANSI)

Vedi anche

Informazioni sui controlli descrizione comando