Creating Multiline ToolTips

9/9/2008

Multilinha suporte dica de ferramenta permite exibir mais de uma linha de texto de dica de ferramenta. Essa opção é útil se sua mensagem é muito longa para um usuário para ler facilmente como uma única linha de texto.

Você cria uma detalhada dica de ferramenta quando você responde ao TTN_GETDISPINFO notificação. Para forçar o controle dica de ferramenta para usar múltiplo linhas, enviar um TTM_SETMAXTIPWIDTH mensagem que especifica a largura do retângulo exibir. O texto que ultrapasse essa largura passará para o próximo linha em vez de ampliando a região exibir. A altura retângulo aumenta quando necessário para acomodar as linhas adicionais. O controle dica de ferramenta quebra de linhas automaticamente. Você também pode usar um retorno de carro/alimentação de linha combinação (\r\n) para Linha forçar quebras em locais específicos.

A reserva de texto na NMTTDISPINFO estrutura acomoda somente 80 caracteres. Se você precisar um seqüência de caracteres mais, defina o lpszText membro das NMTTDISPINFO estrutura para apontar para uma reserva que contém o texto que você desejar usar.

O seguinte exemplo de código mostra um manipulador notificação TTN_GETDISPINFO simples. O exemplo de código cria uma detalhada dica de ferramenta pela configuração o retângulo exibir para 300 pixels e pela configuração de lpszText membro das NMTTDISPINFO estrutura para apontar para uma reserva com o texto para usar.

char szLongMessage[] =
"This message is a long message for the ToolTip that wraps automatically "
"when the length of the message exceeds the maximum tip width. "
"Alternatively, you can use a\r\n"
"carriage return/line feed combination\r\n"
"to force line breaks at specific\r\n"
"locations.";

switch (lpnmhdr->code) {
  case TTN_GETDISPINFO:
    lpttd = (LPNMTTDISPINFO)lpnmhdr;
    SendMessage(lpnmhdr->hwndFrom, TTM_SETMAXTIPWIDTH, 0, 300);
    lpttd->lpszText = szLongMessage;
    return 0;


// Include other notification handlers, as needed.
}

See Also

Concepts

Creating a ToolTip Control