CToolTipCtrl::AddTool

Artigo
02/25/2013

Registra uma ferramenta com o controle 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
Identificação do recurso de cadeia de caracteres que contém o texto para a ferramenta.
lpRectTool
Ponteiro a estrutura de RECT que contém as coordenadas do retângulo delimitador de ferramenta.As coordenadas são relativos ao canto superior esquerdo da área cliente da janela identificada por pWnd.
nIDTool
Identificação de ferramenta.
lpszText
Ponteiro para o texto para a ferramenta.Se este parâmetro contém o valor LPSTR_TEXTCALLBACK, as notificações de TTN_NEEDTEXT vão ao pai da janela que aponta pWnd .

Valor de retorno

Diferente de zero se com êxito; se não 0.

Comentários

Os parâmetros de lpRectTool e de nIDTool devem ser ambos válidos, ou se lpRectTool é NULO, nIDTool deve ser 0.

Um controle dica de ferramenta pode ser associado com mais de uma ferramenta.Chamar essa função para registrar uma ferramenta com o controle dica de ferramenta, para que informações armazenadas na dica de ferramenta é exibida quando o cursor está na ferramenta.