Classe CToolTipCtrl

Encapsula a funcionalidade de um "controle de dica da ferramenta", uma pequena janela pop-up que exibe uma única linha de texto que descreve a finalidade de uma ferramenta em um aplicativo.

Sintaxe

class CToolTipCtrl : public CWnd

Membros

Construtores públicos

Nome	Descrição
CToolTipCtrl::CToolTipCtrl	Constrói um objeto CToolTipCtrl.

Métodos públicos

Nome	Descrição
CToolTipCtrl::Activate	Ativa e desativa o controle de dica da ferramenta.
CToolTipCtrl::AddTool	Registra uma ferramenta com o controle de dica da ferramenta.
CToolTipCtrl::AdjustRect	Converte entre um retângulo de exibição de texto de um controle de dica da ferramenta e seu retângulo de janela.
CToolTipCtrl::Create	Cria um controle de dica da ferramenta e o anexa a um objeto CToolTipCtrl.
CToolTipCtrl::CreateEx	Cria um controle de dica da ferramenta com os estilos estendidos do Windows especificados e o anexa a um objeto CToolTipCtrl.
CToolTipCtrl::DelTool	Remove uma ferramenta do controle de dica da ferramenta.
CToolTipCtrl::GetBubbleSize	Recupera o tamanho da dica da ferramenta.
CToolTipCtrl::GetCurrentTool	Recupera informações, como o tamanho, a posição e o texto, da janela de dica da ferramenta que o controle de dica da ferramenta atual exibe.
CToolTipCtrl::GetDelayTime	Recupera as durações iniciais, pop-up e de reexibição que estão atualmente definidas para um controle de dica da ferramenta.
CToolTipCtrl::GetMargin	Recupera as margens superior, esquerda, inferior e direita definidas para uma janela de dica da ferramenta.
CToolTipCtrl::GetMaxTipWidth	Recupera a largura máxima de uma janela de dica da ferramenta.
CToolTipCtrl::GetText	Recupera o texto que um controle de dica da ferramenta mantém para uma ferramenta.
CToolTipCtrl::GetTipBkColor	Recupera a cor da tela de fundo em uma janela de dica da ferramenta.
CToolTipCtrl::GetTipTextColor	Recupera a cor do texto em uma janela de dica da ferramenta.
CToolTipCtrl::GetTitle	Recupera o título do controle de dica da ferramenta atual.
CToolTipCtrl::GetToolCount	Recupera uma contagem das ferramentas mantidas por um controle de dica da ferramenta.
CToolTipCtrl::GetToolInfo	Recupera as informações que um controle de dica da ferramenta mantém sobre uma ferramenta.
CToolTipCtrl::HitTest	Testa um ponto para determinar se ele está dentro do retângulo delimitador da ferramenta fornecida. Nesse caso, recupera informações sobre a ferramenta.
CToolTipCtrl::Pop	Remove uma janela de dica da ferramenta exibida do modo de exibição.
CToolTipCtrl::Popup	Faz com que o controle de dica da ferramenta atual seja exibido nas coordenadas da última mensagem do mouse.
CToolTipCtrl::RelayEvent	Passa uma mensagem do mouse para um controle de dica da ferramenta para processamento.
CToolTipCtrl::SetDelayTime	Define as durações iniciais, pop-up e reexibição para um controle de dica da ferramenta.
CToolTipCtrl::SetMargin	Define as margens superior, esquerda, inferior e direita para uma janela de dica da ferramenta.
CToolTipCtrl::SetMaxTipWidth	Define a largura máxima de uma janela de dica da ferramenta.
CToolTipCtrl::SetTipBkColor	Define a cor da tela de fundo em uma janela de dica da ferramenta.
CToolTipCtrl::SetTipTextColor	Define a cor do texto em uma janela de dica da ferramenta.
CToolTipCtrl::SetTitle	Adiciona um ícone padrão e uma cadeia de caracteres de título a uma dica de ferramenta.
CToolTipCtrl::SetToolInfo	Define as informações que uma dica de ferramenta mantém para uma ferramenta.
CToolTipCtrl::SetToolRect	Define um novo retângulo delimitador para uma ferramenta.
CToolTipCtrl::SetWindowTheme	Define o estilo visual da janela de dica da ferramenta.
CToolTipCtrl::Update	Força a ferramenta atual a ser redesenhada.
CToolTipCtrl::UpdateTipText	Define o texto da dica de ferramenta para uma ferramenta.

Comentários

Uma "ferramenta" é uma janela, como uma janela ou controle filho, ou uma área retangular definida pelo aplicativo dentro da área de cliente de uma janela. Uma dica de ferramenta fica oculta na maior parte do tempo, aparecendo somente quando o usuário coloca o cursor em uma ferramenta e o deixa lá por aproximadamente meio segundo. A dica de ferramenta aparece perto do cursor e desaparece quando o usuário clica em um botão do mouse ou move o cursor para fora da ferramenta.

CToolTipCtrl fornece a funcionalidade para controlar o tempo inicial e a duração da dica de ferramenta, as larguras da margem ao redor do texto da dica de ferramenta, a largura da própria janela de dica da ferramenta e a cor da tela de fundo e do texto da dica de ferramenta. Um único controle de dica de ferramenta pode fornecer informações para mais de uma ferramenta.

A classe CToolTipCtrl fornece a funcionalidade do controle de dica de ferramenta comum do Windows. Esse controle (e, portanto, a classe CToolTipCtrl) está disponível apenas para programas em execução no Windows 95/98 e Windows NT versões 3.51 e posteriores.

Para obter mais informações sobre como habilitar dicas de ferramentas, consulte Dicas de ferramentas no Windows não derivadas de CFrameWnd.

Para obter mais informações sobre como usar CToolTipCtrl, consulte Controles e Usar CToolTipCtrl.

Hierarquia de herança

CObject

CCmdTarget

CWnd

CToolTipCtrl

Requisitos

Cabeçalho: afxcmn.h

CToolTipCtrl::Activate

Chame essa função para ativar ou desativar um controle de dica de ferramenta.

void Activate(BOOL bActivate);

Parâmetros

bActivate
Especifica se o controle de dica de ferramenta deve ser ativado ou desativado.

Comentários

Se bActivate for TRUE, o controle será ativado; se FALSEestiver desativado.

Quando um controle de dica de ferramenta está ativo, as informações da dica de ferramenta são exibidas assim que o cursor estiver em uma ferramenta registrada com o controle. Quando está inativo, as informações da dica de ferramenta não aparecem, mesmo quando o cursor está em uma ferramenta.

Exemplo

Confira o exemplo de CPropertySheet::GetTabControl.

CToolTipCtrl::AddTool

Registra uma ferramenta com o controle de dica da 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 cadeia de caracteres que contém o texto da ferramenta.

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

nIDTool
ID da ferramenta.

lpszText
Ponteiro para o texto da ferramenta. Se esse parâmetro contiver o valor LPSTR_TEXTCALLBACK, as mensagens de notificação TTN_NEEDTEXT serão enviadas para o pai da janela para a qual pWnd apontar.

Valor de retorno

Diferente de zero se tiver êxito; caso contrário, 0.

Comentários

Os parâmetros lpRectTool e nIDTool devem ser válidos ou, se lpRectTool for NULL, nIDTool deve ser 0.

Um controle de dica de ferramenta pode ser associado a mais de uma ferramenta. Chame essa função para registrar uma ferramenta com o controle de dica de ferramenta, para que as informações armazenadas na dica de ferramenta sejam exibidas quando o cursor estiver na ferramenta.

Observação

Você não pode definir uma dica de ferramenta para um controle estático usando AddTool.

Exemplo

Confira o exemplo de CPropertySheet::GetTabControl.

CToolTipCtrl::AdjustRect

Converte entre um retângulo de exibição de texto de um controle de dica da ferramenta e seu retângulo de janela.

BOOL AdjustRect(
    LPRECT lprc,
    BOOL bLarger = TRUE);

Parâmetros

lprc
Ponteiro para uma estrutura RECT que contém um retângulo de janela de dica da ferramenta ou um retângulo de exibição de texto.

bLarger
Se TRUE, lprc é usado para especificar um retângulo de exibição de texto e ele recebe o retângulo de janela correspondente. Se FALSE, lprc é usado para especificar um retângulo de janela e ele recebe o retângulo de exibição de texto correspondente.

Valor de retorno

Não zero se o retângulo for ajustado com êxito; caso contrário, 0.

Comentários

Essa função membro calcula o retângulo de exibição de texto de um controle de dica de ferramenta do retângulo de janela ou o retângulo da janela da dica de ferramenta necessário para exibir um retângulo de exibição de texto especificado.

Essa função membro implementa o comportamento da mensagem TTM_ADJUSTRECT do Win32, conforme descrito no SDK do Windows.

CToolTipCtrl::Create

Cria um controle de dica da ferramenta e o anexa a um objeto CToolTipCtrl.

virtual BOOL Create(CWnd* pParentWnd, DWORD dwStyle = 0);

Parâmetros

pParentWnd
Especifica a janela pai do controle de dica de ferramenta, geralmente um CDialog. Não deve ser NULL.

dwStyle
Especifica o estilo do controle de dica de ferramenta. Consulte a seção Comentários para obter mais informações.

Valor de retorno

Não zero se o objeto CToolTipCtrl for criado com êxito; caso contrário, 0.

Comentários

O CToolTipCtrl é construído em duas etapas. Primeiro, chame o construtor para criar o objeto CToolTipCtrl e, em seguida, chame Create para criar o controle de dica de ferramenta e anexá-lo ao objeto CToolTipCtrl.

O parâmetro dwStyle pode ser qualquer combinação de Estilos de janela. Além disso, um controle de dica de ferramenta tem dois estilos específicos de classe: TTS_ALWAYSTIP e TTS_NOPREFIX.

Estilo	Significado
TTS_ALWAYSTIP	Especifica que a dica de ferramenta será exibida quando o cursor estiver em uma ferramenta, independentemente de a janela de proprietário do controle de dica de ferramenta estar ativa ou inativa. Sem esse estilo, o controle de dica de ferramenta é exibido quando a janela de proprietário da ferramenta está ativa, mas não quando está inativa.
TTS_NOPREFIX	Esse estilo impede que o sistema remove o caractere E comercial (&) de uma cadeia de caracteres. Se um controle de dica de ferramenta não tiver o estilo TTS_NOPREFIX, o sistema removerá automaticamente caracteres E comercial, permitindo que um aplicativo use a mesma cadeia de caracteres que um item de menu e o texto em um controle de dica de ferramenta.

Um controle de dica de ferramenta tem os estilos de janela WS_POPUP e WS_EX_TOOLWINDOW, independentemente de você especificá-los ao criar o controle.

Para criar um controle de dica de ferramenta com estilos estendidos do Windows, chame CToolTipCtrl::CreateEx em vez de Create.

Exemplo

Confira o exemplo de CPropertySheet::GetTabControl.

CToolTipCtrl::CreateEx

Cria um controle (uma janela filho) e o associa ao objeto CToolTipCtrl.

virtual BOOL CreateEx(
    CWnd* pParentWnd,
    DWORD dwStyle = 0,
    DWORD dwStyleEx = 0);

Parâmetros

pParentWnd
Um ponteiro para a janela que é pai do controle.

dwStyle
Especifica o estilo do controle de dica de ferramenta. Consulte a seção Comentários de Create para obter mais informações.

dwStyleEx
Especifica o estilo estendido do controle que está sendo criado. Para obter uma lista de estilos estendidos do Windows, consulte o parâmetro dwExStyle para CreateWindowEx no SDK do Windows.

Valor de retorno

Diferente de zero se tiver êxito; caso contrário, 0.

Comentários

Use CreateEx, em vez de Create, para aplicar estilos estendidos do Windows, especificados pelo prefácio WS_EX_ de estilos estendidos do Windows.

CToolTipCtrl::CToolTipCtrl

Constrói um objeto CToolTipCtrl.

CToolTipCtrl();

Comentários

Você deve chamar Create depois de criar o objeto.

Exemplo

// Declare a CToolTipCtrl object.
CToolTipCtrl m_ToolTipCtrl;

CToolTipCtrl::DelTool

Remove a ferramenta especificada por pWnd e nIDTool da coleção de ferramentas com suporte por um controle de dica de ferramenta.

void DelTool(
    CWnd* pWnd,
    UINT_PTR nIDTool = 0);

Parâmetros

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

nIDTool
ID da ferramenta.

CToolTipCtrl::GetBubbleSize

Recupera o tamanho da dica da ferramenta.

CSize GetBubbleSize(LPTOOLINFO lpToolInfo) const;

Parâmetros

lpToolInfo
Um ponteiro para a estrutura TOOLINFO da dica de ferramenta.

Valor de retorno

O tamanho da dica de ferramenta.

Comentários

Essa função membro implementa o comportamento da mensagem TTM_GETBUBBLESIZE do Win32, conforme descrito no SDK do Windows.

CToolTipCtrl::GetCurrentTool

Recupera informações, como o tamanho, a posição e o texto, da janela de dica da ferramenta exibida pelo controle de dica de ferramenta atual.

BOOL GetCurrentTool(LPTOOLINFO lpToolInfo) const;

Parâmetros

lpToolInfo
[out] Ponteiro para uma estrutura TOOLINFO que recebe informações sobre a janela de dica da ferramenta atual.

Valor de retorno

TRUE se a informação for recuperada com êxito; caso contrário, FALSE.

Comentários

Esse método envia a mensagem TTM_GETCURRENTTOOL, que é descrita no SDK do Windows.

Exemplo

O exemplo de código a seguir recupera informações sobre a janela de dica da ferramenta atual.

{
    //Get information about the current tooltip. 
    TOOLINFO tInfo = {0};
    tInfo.cbSize = sizeof(TOOLINFO);
    CToolBarCtrl& m_toolBarCtrl = m_wndToolBar.GetToolBarCtrl();
    CToolTipCtrl* m_toolTip = m_toolBarCtrl.GetToolTips();
    BOOL bRet = m_toolTip->GetCurrentTool( &tInfo );
}

CToolTipCtrl::GetDelayTime

Recupera as durações iniciais, de pop-up e de exibição atualmente definidas para um controle de dica de ferramenta.

int GetDelayTime(DWORD dwDuration) const;

Parâmetros

dwDuration
Sinalizador que especifica qual valor de duração será recuperado. Esse parâmetro pode usar um dos valores a seguir:

• TTDT_AUTOPOP Recupera o período de tempo em que a janela da dica de ferramenta permanecerá visível se o ponteiro estiver parado dentro do retângulo delimitador de uma ferramenta.

• TTDT_INITIAL Recupera o período de tempo que o ponteiro deve permanecer parado dentro do retângulo delimitador de uma ferramenta antes que a janela de dica da ferramenta seja exibida.

• TTDT_RESHOW Recupera o período de tempo até que as janelas subsequentes de dica de ferramenta sejam exibidas quando o ponteiro for movido de uma ferramenta para outra.

Valor de retorno

O tempo de atraso especificado, em milissegundos

Comentários

Essa função membro implementa o comportamento da mensagem TTM_GETDELAYTIME do Win32, conforme descrito no SDK do Windows.

CToolTipCtrl::GetMargin

Recupera as margens superior, esquerda, inferior e direita definidas para uma janela de dica da ferramenta.

void GetMargin(LPRECT lprc) const;

Parâmetros

lprc
Endereço de uma estrutura RECT que receberá as informações de margem. Os membros da estrutura RECT não definem um retângulo delimitador. Para os fins desta mensagem, os membros da estrutura são interpretados da seguinte maneira:

Membro	Representação
top	Distância entre a borda superior e a parte superior do texto da dica de ferramenta, em pixels.
left	Distância entre a borda esquerda e a extremidade esquerda do texto da dica, em pixels.
bottom	Distância entre a borda inferior e a parte inferior do texto da dica, em pixels.
right	Distância entre a borda direita e a extremidade direita do texto da dica, em pixels.

Comentários

Essa função membro implementa o comportamento da mensagem TTM_GETMARGIN do Win32, conforme descrito no SDK do Windows.

CToolTipCtrl::GetMaxTipWidth

Recupera a largura máxima de uma janela de dica da ferramenta.

int GetMaxTipWidth() const;

Valor de retorno

A largura máxima de uma janela de dica da ferramenta.

Comentários

Essa função membro implementa o comportamento da mensagem TTM_GETMAXTIPWIDTH do Win32, conforme descrito no SDK do Windows.

CToolTipCtrl::GetText

Recupera o texto que um controle de dica da ferramenta mantém para uma ferramenta.

void GetText(
    CString& str,
    CWnd* pWnd,
    UINT_PTR nIDTool = 0) const;

Parâmetros

str
Referência a um objeto CString que recebe o texto da ferramenta.

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

nIDTool
ID da ferramenta.

Comentários

Os parâmetros pWnd e nIDTool identificam a ferramenta. Se essa ferramenta tiver sido registrada anteriormente com o controle de dica de ferramenta por meio de uma chamada anterior para CToolTipCtrl::AddTool, o objeto referenciado pelo parâmetro str será atribuído ao texto da ferramenta.

CToolTipCtrl::GetTipBkColor

Recupera a cor da tela de fundo em uma janela de dica da ferramenta.

COLORREF GetTipBkColor() const;

Valor de retorno

Um valor COLORREF que representa a cor da tela de fundo.

Comentários

Essa função membro implementa o comportamento da mensagem TTM_GETTIPBKCOLOR do Win32, conforme descrito no SDK do Windows.

CToolTipCtrl::GetTipTextColor

Recupera a cor do texto em uma janela de dica da ferramenta.

COLORREF GetTipTextColor() const;

Valor de retorno

Um valor COLORREF que representa a cor do texto.

Comentários

Essa função membro implementa o comportamento da mensagem TTM_GETTIPTEXTCOLOR do Win32, conforme descrito no SDK do Windows.

CToolTipCtrl::GetTitle

Recupera o título do controle de dica da ferramenta atual.

void GetTitle(PTTGETTITLE pttgt) const;

Parâmetros

pttgt
[out] Ponteiro para uma estrutura TTGETTITLE que contém informações sobre o controle de dica de ferramenta. Quando esse método retorna, o membro pszTitle da estrutura TTGETTITLE aponta para o texto do título.

Comentários

Esse método envia a mensagem TTM_GETTITLE, que é descrita no SDK do Windows.

CToolTipCtrl::GetToolCount

Recupera uma contagem das ferramentas registradas com o controle de dica de ferramenta.

int GetToolCount() const;

Valor de retorno

Uma contagem de ferramentas registradas com o controle de dica de ferramenta.

CToolTipCtrl::GetToolInfo

Recupera as informações que um controle de dica da ferramenta mantém sobre uma ferramenta.

BOOL GetToolInfo(
    CToolInfo& ToolInfo,
    CWnd* pWnd,
    UINT_PTR nIDTool = 0) const;

Parâmetros

ToolInfo
Referência a um objeto TOOLINFO que recebe o texto da ferramenta.

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

nIDTool
ID da ferramenta.

Valor de retorno

Diferente de zero se tiver êxito; caso contrário, 0.

Comentários

Os membros hwnd e uId da estrutura TOOLINFO referenciados pela ferramenta CToolInfo identificam a ferramenta. Se essa ferramenta tiver sido registrada com o controle de dica de ferramenta por meio de uma chamada anterior para AddTool, a estrutura TOOLINFO será preenchida com informações sobre a ferramenta.

CToolTipCtrl::HitTest

Testa um ponto para determinar se ele está dentro do retângulo delimitador da ferramenta fornecida e, se for o caso, recuperar informações sobre a ferramenta.

BOOL HitTest(
    CWnd* pWnd,
    CPoint pt,
    LPTOOLINFO lpToolInfo) const;

Parâmetros

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

pt
Ponteiro para um objeto CPoint que contém as coordenadas do ponto a ser testado.

lpToolInfo
Ponteiro para uma estrutura TOOLINFO que contém informações sobre o controle de dica de ferramenta.

Valor de retorno

Não zero se o ponto especificado pelas informações de teste de ocorrência estiver dentro do retângulo delimitador da ferramenta; caso contrário, 0.

Comentários

Se essa função retornar um valor diferente de zero, a estrutura apontada por lpToolInfo será preenchida com informações sobre a ferramenta dentro de cujo retângulo o ponto está.

A estrutura TTHITTESTINFO é definida como segue:

typedef struct _TT_HITTESTINFO { // tthti
    HWND hwnd;   // handle of tool or window with tool
    POINT pt;    // client coordinates of point to test
    TOOLINFO ti; // receives information about the tool
} TTHITTESTINFO, FAR * LPHITTESTINFO;

• hwnd

  Especifica o identificador da ferramenta.

• pt

  Especifica as coordenadas de um ponto se o ponto estiver no retângulo delimitador da ferramenta.

• ti

  Informações sobre a ferramenta. Para obter mais informações sobre a estrutura TOOLINFO, confira CToolTipCtrl::GetToolInfo.

CToolTipCtrl::Pop

Remove uma janela de dica da ferramenta exibida do modo de exibição.

void Pop();

Comentários

Essa função membro implementa o comportamento da mensagem TTM_POP do Win32, conforme descrito no SDK do Windows.

CToolTipCtrl::Popup

Faz com que o controle de dica da ferramenta atual seja exibido nas coordenadas da última mensagem do mouse.

void Popup();

Comentários

Esse método envia a mensagem TTM_POPUP, que é descrita no SDK do Windows.

Exemplo

O exemplo de código a seguir exibe uma janela de dica da ferramenta.

{
   // Display the most recent tooltip.
   CToolBarCtrl &m_toolBarCtrl = m_wndToolBar.GetToolBarCtrl();
   CToolTipCtrl *m_toolTip = m_toolBarCtrl.GetToolTips();
   m_toolTip->Popup();
}

CToolTipCtrl::RelayEvent

Passa uma mensagem do mouse para um controle de dica da ferramenta para processamento.

void RelayEvent(LPMSG lpMsg);

Parâmetros

lpMsg
Ponteiro para uma estrutura MSG que contém a mensagem a ser retransmitida.

Comentários

Um controle de dica de ferramenta processa apenas as seguintes mensagens, que são enviadas a ela por RelayEvent:

WM_LBUTTONDOWN	WM_MOUSEMOVE
WM_LBUTTONUP	WM_RBUTTONDOWN
WM_MBUTTONDOWN	WM_RBUTTONUP
WM_MBUTTONUP

Exemplo

Confira o exemplo de CPropertySheet::GetTabControl.

CToolTipCtrl::SetDelayTime

Define o tempo de atraso para um controle de dica de ferramenta.

void SetDelayTime(UINT nDelay);

void SetDelayTime(
    DWORD dwDuration,
    int iTime);

Parâmetros

nDelay
Especifica o novo tempo de atraso, em milissegundos.

dwDuration
Sinalizador que especifica qual valor de duração será recuperado. Consulte CToolTipCtrl::GetDelayTime para obter uma descrição completa das valores válidos.

iTime
O tempo de atraso especificado, em milissegundos.

Comentários

O tempo de atraso é o período de tempo que o cursor deve permanecer em uma ferramenta antes que a janela da dica de ferramenta seja exibida. O tempo de atraso padrão é de 500 milissegundos.

CToolTipCtrl::SetMargin

Define as margens superior, esquerda, inferior e direita para uma janela de dica da ferramenta.

void SetMargin(LPRECT lprc);

Parâmetros

lprc
Endereço de uma estrutura RECT que contém as informações de margem a serem definidas. Os membros da estrutura RECT não definem um retângulo delimitador. Consulte CToolTipCtrl::GetMargin para obter uma descrição das informações de margem.

Comentários

Essa função membro implementa o comportamento da mensagem TTM_SETMARGIN do Win32, conforme descrito no SDK do Windows.

CToolTipCtrl::SetMaxTipWidth

Define a largura máxima de uma janela de dica da ferramenta.

int SetMaxTipWidth(int iWidth);

Parâmetros

iWidth
A largura máxima da janela de dica da ferramenta a ser definida.

Valor de retorno

A largura máxima da dica anterior.

Comentários

Essa função membro implementa o comportamento da mensagem TTM_SETMAXTIPWIDTH do Win32, conforme descrito no SDK do Windows.

CToolTipCtrl::SetTipBkColor

Define a cor da tela de fundo em uma janela de dica da ferramenta.

void SetTipBkColor(COLORREF clr);

Parâmetros

clr
A nova cor da tela de fundo.

Comentários

Essa função membro implementa o comportamento da mensagem TTM_SETTIPBKCOLOR do Win32, conforme descrito no SDK do Windows.

CToolTipCtrl::SetTipTextColor

Define a cor do texto em uma janela de dica da ferramenta.

void SetTipTextColor(COLORREF clr);

Parâmetros

clr
A nova cor do texto.

Comentários

Essa função membro implementa o comportamento da mensagem TTM_SETTIPTEXTCOLOR do Win32, conforme descrito no SDK do Windows.

CToolTipCtrl::SetTitle

Adiciona um ícone padrão e uma cadeia de caracteres de título a uma dica de ferramenta.

BOOL SetTitle(
    UINT uIcon,
    LPCTSTR lpstrTitle);

Parâmetros

uIcon
Consulte icon em TTM_SETTITLE no SDK do Windows.

lpstrTitle
Ponteiro que indica a cadeia de caracteres do título.

Valor de retorno

Diferente de zero se tiver êxito; caso contrário, 0.

Comentários

Essa função membro implementa o comportamento da mensagem TTM_SETTITLE do Win32, conforme descrito no SDK do Windows.

CToolTipCtrl::SetToolInfo

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

void SetToolInfo(LPTOOLINFO lpToolInfo);

Parâmetros

lpToolInfo
Um ponteiro para uma estrutura TOOLINFO que especifica as informações a serem definidas.

CToolTipCtrl::SetToolRect

Define um novo retângulo delimitador para uma ferramenta.

void SetToolRect(
    CWnd* pWnd,
    UINT_PTR nIDTool,
    LPCRECT lpRect);

Parâmetros

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

nIDTool
ID da ferramenta.

lpRect
Ponteiro para uma estrutura RECT que especifica o novo retângulo delimitador.

CToolTipCtrl::SetWindowTheme

Define o estilo visual da janela de dica da ferramenta.

HRESULT SetWindowTheme(LPCWSTR pszSubAppName);

Parâmetros

pszSubAppName
Um ponteiro para uma cadeia de caracteres Unicode que contém o estilo visual a ser definido.

Valor de retorno

O valor retornado não é usado.

Comentários

Essa função de membro emula a funcionalidade da mensagem TTM_SETWINDOWTHEME, conforme descrito no SDK do Windows.

CToolTipCtrl::Update

Força a ferramenta atual a ser redesenhada.

void Update();

CToolTipCtrl::UpdateTipText

Atualiza o texto da dica de ferramenta para as ferramentas desse controle.

void UpdateTipText(
    LPCTSTR lpszText,
    CWnd* pWnd,
    UINT_PTR nIDTool = 0);

void UpdateTipText(
    UINT nIDText,
    CWnd* pWnd,
    UINT_PTR nIDTool = 0);

Parâmetros

lpszText
Ponteiro para o texto da ferramenta.

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

nIDTool
ID da ferramenta.

nIDText
ID do recurso de cadeia de caracteres que contém o texto da ferramenta.

Confira também

Classe CWnd
Gráfico da hierarquia
Classe CToolBar