Compartilhar via


CToolTipCtrl::AddTool

Registra uma ferramenta com o controle de dica de ferramenta.

BOOL AddTool(
   CWnd* pWnd,
   UINT nIDText,
   LPCRECT lpRectTool = NULL,
   UINT_PTR nIDTool = 0 
);
BOOL AddTool(
   CWnd* pWnd,
   LPCTSTR lpszText = LPSTR_TEXTCALLBACK,
   LPCRECT lpRectTool = NULL,
   UINT_PTR nIDTool = 0 
);

Parâmetros

  • pWnd
    Ponteiro para a janela que contém a ferramenta.

  • nIDText
    ID do recurso de seqüência de caracteres que contém o texto para a ferramenta.

  • lpRectTool
    Ponteiro para um RECT estrutura que contém coordenadas do retângulo delimitador da ferramenta.As coordenadas serão relativas ao canto superior esquerdo da área de cliente da janela identificada por pWnd.

  • nIDTool
    ID da ferramenta.

  • lpszText
    Ponteiro para o texto para a ferramenta.Se esse parâmetro tiver o valor LPSTR_TEXTCALLBACK, TTN_NEEDTEXT mensagens de notificação de vá para o pai da janela que pWnd aponta para.

Valor de retorno

Diferente de zero se bem-sucedida; caso contrário, 0.

Comentários

The lpRectTool and nIDTool parâmetros devem ser válido, ou se lpRectTool is nulo, nIDTool deve ser 0.

Um controle de dica de ferramenta pode ser associado a mais de uma ferramenta.telefonar Esta função para registrar uma ferramenta com o controle de dica de ferramenta, para que as informações armazenadas na dica de ferramenta seja exibidas quando o cursor está sobre a ferramenta.

Observação:

Não é possível conjunto uma dica de ferramenta para um controle estático usando AddTool.

Exemplo

Consulte o exemplo para CPropertySheet::GetTabControl.

Requisitos

Cabeçalho: afxcmn.h

Consulte também

Referência

Classe CToolTipCtrl

Gráfico de hierarquia

CToolTipCtrl::DelTool

Outros recursos

CToolTipCtrl membros