Compartilhar via


TTM_SETTOOLINFO mensagem

Define as informações que um controle de dica de ferramenta mantém para uma ferramenta.

Parâmetros

wParam

Deve ser zero.

lParam

Ponteiro para uma estrutura TOOLINFO que especifica as informações a serem definidas. O membro cbSize dessa estrutura deve ser definido antes de enviar essa mensagem.

Valor retornado

Sem valor de retorno.

Comentários

Algumas propriedades internas de uma ferramenta são estabelecidas quando a ferramenta é criada e não são recomputadas quando uma mensagem TTM_SETTOOLINFO é enviada. Se você simplesmente atribuir valores a uma estrutura TOOLINFO e passá-la para o controle de dica de ferramenta com uma mensagem TTM_SETTOOLINFO , essas propriedades poderão ser perdidas. Em vez disso, seu aplicativo deve primeiro solicitar a estrutura TOOLINFO atual da ferramenta enviando ao controle de dica de ferramenta uma mensagem TTM_GETTOOLINFO . Em seguida, modifique os membros dessa estrutura conforme necessário e passe-os de volta para o controle de dica de ferramenta com TTM_SETTOOLINFO.

Ao chamar TTM_SETTOOLINFO, a cadeia de caracteres apontada pelo membro lpszText da estrutura TOOLINFO não deve exceder 80 TCHARs de comprimento, incluindo o NULL de terminação.

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_SETTOOLINFOW (Unicode) e TTM_SETTOOLINFOA (ANSI)