Compartilhar via


TTM_SETTITLE mensagem

Adiciona um ícone padrão e uma cadeia de caracteres de título a uma dica de ferramenta.

Parâmetros

wParam

Defina wParam como um dos valores a seguir para especificar o ícone a ser exibido. A partir do Windows Vista e posterior, esse parâmetro também pode conter um valor HICON . Qualquer valor maior que TTI_ERROR_LARGE é considerado um HICON.

Valor Significado
TTI_NONE
Nenhum ícone.
TTI_INFO
Ícone de informações.
TTI_WARNING
Ícone de aviso:
TTI_ERROR
Ícone de erro
TTI_INFO_LARGE
Ícone de erro grande
TTI_WARNING_LARGE
Ícone de erro grande
TTI_ERROR_LARGE
Ícone de erro grande

lParam

Ponteiro que indica a cadeia de caracteres do título. Você deve atribuir um valor a lParam.

Retornar valor

Retornará TRUE se tiver êxito, FALSE se não for.

Comentários

O título de uma dica de ferramenta aparece acima do texto, em uma fonte diferente. Não é suficiente ter um título; a dica de ferramenta também deve ter texto ou não é exibida.

Quando wParam contém um HICON, uma cópia do ícone é criada pela janela de dica de ferramenta.

Ao chamar TTM_SETTITLE, a cadeia de caracteres apontada por lParam não deve exceder 100 TCHARs de comprimento, incluindo o NULL de terminação.

Exemplos

O exemplo a seguir mostra como adicionar um título e um ícone do sistema a uma dica de ferramenta.

// 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 com suporte
Windows Vista [somente aplicativos da área de trabalho]
Servidor mínimo com suporte
Windows Server 2003 [somente aplicativos da área de trabalho]
Cabeçalho
Commctrl.h
Nomes Unicode e ANSI
TTM_SETTITLEW (Unicode) e TTM_SETTITLEA (ANSI)

Veja também

Sobre controles de dica de ferramenta