Compartilhar via


Estrutura TOOLTIPTEXT

Ao escrever o manipulador de notificação de dica de ferramenta, você precisa usar a estrutura TOOLTIPTEXT. Os membros da estrutura TOOLTIPTEXT são:

typedef struct {
    NMHDR     hdr;        // required for all WM_NOTIFY messages
    LPTSTR    lpszText;   // see below
    TCHAR     szText[80]; // buffer for tool tip text
    HINSTANCE hinst;      // see below
    UINT      uflags;     // flag indicating how to interpret the
                          // idFrom member of the NMHDR structure
                          // that is included in the structure
} TOOLTIPTEXT, FAR *LPTOOLTIPTEXT;

hdr
Identifica a ferramenta que precisa de texto. O único membro dessa estrutura que talvez seja necessário é a ID de comando do controle. A ID de comando do controle estará no membro idFrom da estrutura NMHDR, acessível pela sintaxe hdr.idFrom. Consulte NMHDR para obter uma discussão sobre os membros da estrutura NMHDR.

lpszTexto
Endereço de uma cadeia de caracteres para receber o texto de uma ferramenta.

szText
Buffer que recebe o texto da dica de ferramenta. Um aplicativo pode copiar o texto para esse buffer como alternativa a especificar um endereço de cadeia de caracteres.

hinst
Identificador da instância que contém uma cadeia de caracteres a ser usada como o texto da dica de ferramenta. Se lpszText for o endereço do texto da dica de ferramenta, esse membro será NULL.

Ao manipular a mensagem de notificação TTN_NEEDTEXT, especifique a cadeia de caracteres a ser exibida de uma das seguintes maneiras:

  • Copie o texto para o buffer especificado pelo membro szText.

  • Copie o endereço do buffer que contém o texto para o membro lpszText.

  • Copie o identificador de um recurso de cadeia de caracteres para o membro lpszText, e então copie o identificador da instância que contém o recurso para o membro hinst.

Confira também

Dicas de ferramenta no Windows não derivadas de CFrameWnd