Partilhar via

CToolTipCtrl Classe

Observação

A biblioteca Microsoft Foundation Classes (MFC) continua a ser suportada. No entanto, já não estamos a adicionar funcionalidades nem a atualizar a documentação.

Encapsula a funcionalidade de um "controlo de tooltip", uma pequena janela pop-up que mostra uma única linha de texto descrevendo o propósito de uma ferramenta numa aplicação.

Sintaxe

class CToolTipCtrl : public CWnd

Membros

Construtores Públicos

Nome Description
CToolTipCtrl::CToolTipCtrl Constrói um CToolTipCtrl objeto.

Métodos Públicos

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

Observações

Uma "ferramenta" é ou uma janela, como uma janela filho ou controlo, ou uma área retangular definida pela aplicação dentro da área cliente de uma janela. Uma dica de ferramenta está escondida na maior parte do tempo, aparecendo apenas quando o utilizador coloca o cursor numa ferramenta e a deixa lá durante aproximadamente meio segundo. A dica de ferramenta aparece perto do cursor e desaparece quando o utilizador clica num botão do rato 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 das margens em redor do texto da dica, a largura da própria janela da dica e a cor de fundo e do texto da dica. Um único controlo de tooltip pode fornecer informação para mais do que uma ferramenta.

A CToolTipCtrl classe fornece a funcionalidade do controlo de tooltip comum do Windows. Este controlo (e, portanto, a CToolTipCtrl classe) está disponível apenas para programas a correr sob Windows 95/98 e Windows NT versões 3.51 e posteriores.

Para mais informações sobre como ativar tooltips, consulte Tooltips no Windows não Derivado de CFrameWnd.

Para mais informações sobre a utilização CToolTipCtrlde , veja Controlos e Utilização CToolTipCtrlde .

Hierarquia de herança

CObject

CCmdTarget

CWnd

CToolTipCtrl

Requerimentos

Cabeçalho:afxcmn.h

CToolTipCtrl::Activate

Chame esta função para ativar ou desativar um controlo tooltip.

void Activate(BOOL bActivate);

Parâmetros

bActivate
Especifica se o controlo de tooltip deve ser ativado ou desativado.

Observações

Se bActivate for TRUE, o controlo é ativado; se FALSE, é desativado.

Quando um controlo de tooltip está ativo, a informação da tooltip aparece quando o cursor está numa ferramenta registada no controlo; Quando está inativa, a informação da dica não aparece, mesmo quando o cursor está numa ferramenta.

Example

Veja o exemplo para CPropertySheet::GetTabControl.

CToolTipCtrl::AddTool

Regista uma ferramenta com o controlo tooltip.

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
Apontar para a janela que contém a ferramenta.

nIDText
ID do recurso string que contém o texto da ferramenta.

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

nIDTool
ID da ferramenta.

lpszText
Aponta para o texto da ferramenta. Se este parâmetro contiver o valor LPSTR_TEXTCALLBACK, TTN_NEEDTEXT as mensagens de notificação vão para o pai da janela para onde pWnd aponta.

Valor de retorno

Não nulo se for bem-sucedido; caso contrário, 0.

Observações

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

Um controlo de tooltip pode estar associado a mais do que uma ferramenta. Chame esta função para registar uma ferramenta com o controlo da dica de ferramenta, de modo a que a informação armazenada na dica seja exibida quando o cursor está na ferramenta.

Observação

Não pode definir uma dica de ferramenta para um controlo estático usando AddTool.

Example

Veja o exemplo para CPropertySheet::GetTabControl.

CToolTipCtrl::AdjustRect

Converte entre o retângulo de ecrã de texto de um controlo tooltip e o seu retângulo de janela.

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

Parâmetros

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

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

Valor de retorno

Não nulo se o retângulo for ajustado com sucesso; caso contrário, 0.

Observações

Esta função membro calcula o retângulo de exibição de texto de um controlo de tooltip a partir do seu retângulo de janela, ou do retângulo de janela de tooltip necessário para exibir um retângulo de texto especificado.

Esta função membro implementa o comportamento da mensagem TTM_ADJUSTRECTWin32 , conforme descrito no SDK do Windows.

CToolTipCtrl::Create

Cria um controlo de dica e anexa-o a um CToolTipCtrl objeto.

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

Parâmetros

pParentWnd
Especifica a janela pai do controlo tooltip, normalmente um CDialog. Não pode ser NULL.

dwStyle
Especifica o estilo do controlo da tooltip. Consulte a secção de Observações para mais informações.

Valor de retorno

Não nulo se o CToolTipCtrl objeto for criado com sucesso; caso contrário, 0.

Observações

Constróis um A CToolTipCtrl em dois passos. Primeiro, chama o construtor para construir o CToolTipCtrl objeto, e depois chama Create para criar o controlo tooltip e anexá-lo ao CToolTipCtrl objeto.

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

Estilo Meaning
TTS_ALWAYSTIP Especifica que a dica de ferramenta aparecerá quando o cursor estiver numa ferramenta, independentemente de a janela proprietária do controlo da tooltip estar ativa ou inativa. Sem este estilo, o controlo da tooltip aparece quando a janela proprietária da ferramenta está ativa, mas não quando está inativa.
TTS_NOPREFIX Este estilo impede que o sistema retire o carácter ampersand (&) de uma corda. Se um controlo tooltip não tiver o TTS_NOPREFIX estilo, o sistema remove automaticamente os caracteres ampersand, permitindo que uma aplicação use a mesma string tanto como item de menu como texto num controlo de tooltip.

Um controlo tooltip tem os WS_POPUP estilos e WS_EX_TOOLWINDOW janela, independentemente de os especificar ao criar o controlo.

Para criar um controlo tooltip com estilos de Windows estendidos, chame CToolTipCtrl::CreateEx em vez de Create.

Example

Veja o exemplo para CPropertySheet::GetTabControl.

CToolTipCtrl::CreateEx

Cria um controlo (uma janela filha) e associa-o ao CToolTipCtrl objeto.

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

Parâmetros

pParentWnd
Um apontador para a janela que é o pai do controlo.

dwStyle
Especifica o estilo do controlo da tooltip. Consulte a secção de Observações de Create para mais informações.

dwStyleEx
Especifica o estilo estendido do controlo que está a ser criado. Para uma lista de estilos extensos do Windows, consulte o dwExStyle parâmetro para CreateWindowEx no SDK do Windows.

Valor de retorno

Diferente de zero se for bem-sucedido, caso contrário 0.

Observações

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

CToolTipCtrl::CToolTipCtrl

Constrói um CToolTipCtrl objeto.

CToolTipCtrl();

Observações

Deve ligar Create depois de construir o objeto.

Example

// Declare a CToolTipCtrl object.
CToolTipCtrl m_ToolTipCtrl;

CToolTipCtrl::DelTool

Remove a ferramenta especificada por pWnd e nIDTool da coleção de ferramentas suportadas por um controlo de tooltip.

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

Parâmetros

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

nIDTool
ID da ferramenta.

CToolTipCtrl::GetBubbleSize

Recupera o tamanho da dica de ferramenta.

CSize GetBubbleSize(LPTOOLINFO lpToolInfo) const;

Parâmetros

lpToolInfo
Um apontador para a estrutura da TOOLINFO tooltip.

Valor de retorno

O tamanho da dica de ferramenta.

Observações

Esta função membro implementa o comportamento da mensagem TTM_GETBUBBLESIZEWin32 , conforme descrito no SDK do Windows.

CToolTipCtrl::GetCurrentTool

Recupera informações, como o tamanho, a posição e o texto, da janela de tooltip apresentada pelo controlo atual da tooltip.

BOOL GetCurrentTool(LPTOOLINFO lpToolInfo) const;

Parâmetros

lpToolInfo
[fora] Apontar para uma TOOLINFO estrutura que recebe informação sobre a janela de tooltip atual.

Valor de retorno

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

Observações

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

Example

O exemplo de código seguinte recupera informações sobre a janela de tooltip 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, pop-up e de reapresentação atualmente definidas para um controlo tooltip.

int GetDelayTime(DWORD dwDuration) const;

Parâmetros

dwDuration
Flag que especifica qual valor de duração será recuperado. Este parâmetro pode ser um dos seguintes valores:

  • TTDT_AUTOPOP Recupere o tempo em que a janela de tooltip permanece visível se o ponteiro estiver estacionário dentro do retângulo delimitador da ferramenta.

  • TTDT_INITIAL Recupere o tempo em que o ponteiro deve permanecer parado dentro do retângulo delimitador da ferramenta antes de aparecer a janela de dica da ferramenta.

  • TTDT_RESHOW Recupere o tempo que demora a aparecer as janelas de tooltip subsequentes à medida que o ponteiro passa de uma ferramenta para outra.

Valor de retorno

O tempo de atraso especificado, em milissegundos

Observações

Esta função membro implementa o comportamento da mensagem TTM_GETDELAYTIMEWin32 , conforme descrito no SDK do Windows.

CToolTipCtrl::GetMargin

Recupera as margens superior, esquerda, inferior e direita definidas para uma janela de tooltip.

void GetMargin(LPRECT lprc) const;

Parâmetros

lprc
Endereço de uma RECT estrutura que receberá a informação da margem. Os elementos da RECT estrutura não definem um retângulo delimitador. Para efeitos desta mensagem, os membros da estrutura são interpretados da seguinte forma:

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

Observações

Esta função membro implementa o comportamento da mensagem TTM_GETMARGINWin32 , conforme descrito no SDK do Windows.

CToolTipCtrl::GetMaxTipWidth

Recupera a largura máxima para uma janela de tooltip.

int GetMaxTipWidth() const;

Valor de retorno

A largura máxima para uma janela de tooltip.

Observações

Esta função membro implementa o comportamento da mensagem TTM_GETMAXTIPWIDTHWin32 , conforme descrito no SDK do Windows.

CToolTipCtrl::GetText

Recupera o texto que um controlo tooltip mantém para uma ferramenta.

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

Parâmetros

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

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

nIDTool
ID da ferramenta.

Observações

Os pWnd parâmetros e nIDTool identificam a ferramenta. Se essa ferramenta já foi previamente registada com o controlo tooltip através de uma chamada anterior para CToolTipCtrl::AddTool, o objeto referenciado pelo str parâmetro recebe o texto da ferramenta.

CToolTipCtrl::GetTipBkColor

Recupera a cor de fundo numa janela de tooltip.

COLORREF GetTipBkColor() const;

Valor de retorno

Um COLORREF valor que representa a cor de fundo.

Observações

Esta função membro implementa o comportamento da mensagem TTM_GETTIPBKCOLORWin32 , conforme descrito no SDK do Windows.

CToolTipCtrl::GetTipTextColor

Recupera a cor do texto numa janela de tooltip.

COLORREF GetTipTextColor() const;

Valor de retorno

Um COLORREF valor que representa a cor do texto.

Observações

Esta função membro implementa o comportamento da mensagem TTM_GETTIPTEXTCOLORWin32 , conforme descrito no SDK do Windows.

CToolTipCtrl::GetTitle

Recupera o título do controlo atual da tooltip.

void GetTitle(PTTGETTITLE pttgt) const;

Parâmetros

pttgt
[fora] Apontador para uma TTGETTITLE estrutura que contém informação sobre o controlo da tooltip. Quando este método regressa, o pszTitle membro da TTGETTITLE estrutura aponta para o texto do título.

Observações

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

CToolTipCtrl::GetToolCount

Recupera a contagem das ferramentas registadas no controlo de tooltip.

int GetToolCount() const;

Valor de retorno

Uma contagem de ferramentas registadas no controlo tooltip.

CToolTipCtrl::GetToolInfo

Recupera a informação que um controlo de tooltip mantém sobre uma ferramenta.

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

Parâmetros

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

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

nIDTool
ID da ferramenta.

Valor de retorno

Não nulo se for bem-sucedido; caso contrário, 0.

Observações

Os hwnd membros e uId da TOOLINFO estrutura referenciada por CToolInfo identificam a ferramenta. Se essa ferramenta tiver sido registada com o controlo tooltip através de uma chamada anterior para AddTool, a TOOLINFO estrutura é preenchida com informação sobre a ferramenta.

CToolTipCtrl::HitTest

Testa um ponto para determinar se está dentro do retângulo delimitador da ferramenta dada e, em caso afirmativo, recupera informações sobre a ferramenta.

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

Parâmetros

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

pt
Apontador para um CPoint objeto contendo as coordenadas do ponto a ser testado.

lpToolInfo
Apontador para TOOLINFO uma estrutura que contém informação sobre a ferramenta.

Valor de retorno

Não nulo se o ponto especificado pela informação do teste de acerto estiver dentro do retângulo delimitador da ferramenta; caso contrário, 0.

Observações

Se esta função devolver um valor diferente de zero, a estrutura apontada por lpToolInfo é preenchida com informação sobre a ferramenta dentro do retângulo em cujo ponto se encontra.

A TTHITTESTINFO estrutura é definida da seguinte forma:

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 cabo da ferramenta.

  • pt

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

  • ti

    Informação sobre a ferramenta. Para mais informações sobre a TOOLINFO estrutura, veja CToolTipCtrl::GetToolInfo.

CToolTipCtrl::Pop

Remove uma janela de tooltip exibida da vista.

void Pop();

Observações

Esta função membro implementa o comportamento da mensagem TTM_POPWin32 , conforme descrito no SDK do Windows.

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

void Popup();

Observações

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

Example

O seguinte exemplo de código apresenta uma janela de tooltip.

{
   // 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 rato para um controlo de tooltip para processamento.

void RelayEvent(LPMSG lpMsg);

Parâmetros

lpMsg
Apontador para uma MSG estrutura que contém a mensagem a transmitir.

Observações

Um controlo de tooltip processa apenas as seguintes mensagens, que lhe são enviadas por RelayEvent:

WM_LBUTTONDOWN WM_MOUSEMOVE
WM_LBUTTONUP WM_RBUTTONDOWN
WM_MBUTTONDOWN WM_RBUTTONUP
WM_MBUTTONUP

Example

Veja o exemplo para CPropertySheet::GetTabControl.

CToolTipCtrl::SetDelayTime

Define o tempo de atraso para um controlo de tooltip.

void SetDelayTime(UINT nDelay);

void SetDelayTime(
    DWORD dwDuration,
    int iTime);

Parâmetros

nDelay
Especifica o novo tempo de atraso, em milissegundos.

dwDuration
Flag que especifica qual valor de duração será recuperado. Veja CToolTipCtrl::GetDelayTime para uma descrição dos valores válidos.

iTime
O tempo de atraso especificado, em milissegundos.

Observações

O tempo de atraso é o tempo em que o cursor deve permanecer numa ferramenta antes de aparecer a janela de tooltip. O tempo de atraso padrão é de 500 milissegundos.

CToolTipCtrl::SetMargin

Define as margens superior, esquerda, inferior e direita para uma janela de tooltip.

void SetMargin(LPRECT lprc);

Parâmetros

lprc
Endereço de uma RECT estrutura que contém a informação de margem a definir. Os elementos da RECT estrutura não definem um retângulo delimitador. Veja CToolTipCtrl::GetMargin uma descrição da informação das margens.

Observações

Esta função membro implementa o comportamento da mensagem TTM_SETMARGINWin32 , conforme descrito no SDK do Windows.

CToolTipCtrl::SetMaxTipWidth

Define a largura máxima para uma janela de tooltip.

int SetMaxTipWidth(int iWidth);

Parâmetros

iWidth
A largura máxima da janela tooltip a definir.

Valor de retorno

A largura máxima da ponta anterior.

Observações

Esta função membro implementa o comportamento da mensagem TTM_SETMAXTIPWIDTHWin32 , conforme descrito no SDK do Windows.

CToolTipCtrl::SetTipBkColor

Define a cor de fundo numa janela tooltip.

void SetTipBkColor(COLORREF clr);

Parâmetros

clr
A nova cor de fundo.

Observações

Esta função membro implementa o comportamento da mensagem TTM_SETTIPBKCOLORWin32 , conforme descrito no SDK do Windows.

CToolTipCtrl::SetTipTextColor

Define a cor do texto numa janela de tooltip.

void SetTipTextColor(COLORREF clr);

Parâmetros

clr
A nova cor do texto.

Observações

Esta função membro implementa o comportamento da mensagem TTM_SETTIPTEXTCOLORWin32 , conforme descrito no SDK do Windows.

CToolTipCtrl::SetTitle

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

BOOL SetTitle(
    UINT uIcon,
    LPCTSTR lpstrTitle);

Parâmetros

uIcon
Veja icon no TTM_SETTITLE SDK do Windows.

lpstrTitle
Apontar para a cadeia de títulos.

Valor de retorno

Não nulo se for bem-sucedido; caso contrário, 0.

Observações

Esta função membro implementa o comportamento da mensagem TTM_SETTITLEWin32 , conforme descrito no SDK do Windows.

CToolTipCtrl::SetToolInfo

Define a informação que uma tooltip mantém para uma ferramenta.

void SetToolInfo(LPTOOLINFO lpToolInfo);

Parâmetros

lpToolInfo
Um apontador para uma TOOLINFO estrutura que especifica a informação a definir.

CToolTipCtrl::SetToolRect

Define um novo retângulo delimitador para uma ferramenta.

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

Parâmetros

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

nIDTool
ID da ferramenta.

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

CToolTipCtrl::SetWindowTheme

Define o estilo visual da janela tooltip.

HRESULT SetWindowTheme(LPCWSTR pszSubAppName);

Parâmetros

pszSubAppName
Um ponteiro para uma string Unicode que contém o estilo visual a definir.

Valor de retorno

O valor de retorno não é utilizado.

Observações

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

CToolTipCtrl::Update

Obriga a redesenhar a ferramenta atual.

void Update();

CToolTipCtrl::UpdateTipText

Atualiza o texto da tooltip para as ferramentas deste controlo.

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

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

Parâmetros

lpszText
Aponta para o texto da ferramenta.

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

nIDTool
ID da ferramenta.

nIDText
ID do recurso string que contém o texto da ferramenta.

Consulte também

CWnd Classe
Gráfico de Hierarquia
CToolBar Classe

  • Last updated on