Partilhar via


Classe CMFCToolTipInfo

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.

Armazena informação sobre a aparência visual das dicas de ferramenta.

Sintaxe

class CMFCToolTipInfo

Membros

Métodos Públicos

Nome Description
CMFCToolTipInfo::operator=

Membros de Dados

Nome Description
CMFCToolTipInfo::m_bBalloonTooltip Uma variável booleana que indica se a dica de ferramenta tem uma aparência de balão.
CMFCToolTipInfo::m_bBoldLabel Uma variável booleana que indica se as etiquetas das dicas de ferramenta são exibidas em fonte a negrito.
CMFCToolTipInfo::m_bDrawDescription Uma variável booleana que indica se a dica de ferramenta contém uma descrição.
CMFCToolTipInfo::m_bDrawIcon Uma variável booleana que indica se a dica contém um ícone.
CMFCToolTipInfo::m_bDrawSeparator Uma variável booleana que indica se um separador é exibido entre o rótulo da tooltip e a descrição da tooltip.
CMFCToolTipInfo::m_bRoundedCorners Uma variável booleana que indica se a dica de ferramenta tem cantos arredondados.
CMFCToolTipInfo::m_bVislManagerTheme Uma variável booleana que indica se a aparência da tooltip deve ser controlada por um gestor visual (ver CMFCVisualManager Class).
CMFCToolTipInfo::m_clrBorder A cor da borda da dica de ferramenta.
CMFCToolTipInfo::m_clrFill A cor do fundo da dica de ferramenta.
CMFCToolTipInfo::m_clrFillGradient A cor do gradiente preenche na dica de ferramenta.
CMFCToolTipInfo::m_clrText A cor do texto na dica de ferramenta.
CMFCToolTipInfo::m_nGradientAngle O ângulo do gradiente preenche a dica de ferramenta.
CMFCToolTipInfo::m_nMaxDescrWidth A largura máxima possível, em píxeis, da descrição na dica de ferramenta.

Observações

Use CMFCToolTipCtrl Class, CMFCToolTipInfo, e CTooltipManager Class em conjunto para implementar tooltips personalizadas na sua aplicação. Para um exemplo de como usar estas classes tooltip, veja o tópico CMFCToolTipCtrl Class .

Example

O exemplo seguinte demonstra como definir os valores das várias variáveis membros na CMFCToolTipInfo classe.

CMFCToolTipInfo *params = new CMFCToolTipInfo();

params->m_bBoldLabel = FALSE;
params->m_bDrawDescription = FALSE;
params->m_bDrawIcon = FALSE;
params->m_bRoundedCorners = TRUE;
params->m_bDrawSeparator = FALSE;
params->m_clrFill = RGB(255, 255, 255);
params->m_clrFillGradient = RGB(228, 228, 240);
params->m_clrText = RGB(61, 83, 80);
params->m_clrBorder = RGB(144, 149, 168);

Hierarquia de herança

CMFCToolTipInfo

Requerimentos

Cabeçalho: afxtooltipctrl.h

CMFCToolTipInfo::m_bBalloonTooltip

Especifica o estilo de exibição de todas as dicas de ferramenta.

BOOL m_bBalloonTooltip;

Observações

TRUE indica que as descrições usam o estilo balão, FALSE indica que as descrições usam o estilo retangular.

CMFCToolTipInfo::m_bBoldLabel

Especifica se a fonte do texto da tooltip está a negrito.

BOOL m_bBoldLabel;

Observações

Defina este membro como TRUE para mostrar texto de dica de ferramenta com fonte a negrito, ou FALSE para mostrar as etiquetas das dicas com fonte sem negrito.

CMFCToolTipInfo::m_bDrawDescription

Especifica se cada tooltip apresenta o texto da descrição.

BOOL m_bDrawDescription;

Observações

Defina este membro como TRUE para mostrar a descrição, ou FALSE para ocultar a descrição. Pode especificar a descrição numa dica de ferramenta chamando CMFCToolTipCtrl::SetDescription

CMFCToolTipInfo::m_bDrawIcon

Especifica se todas as dicas de ferramenta exibem ícones.

BOOL m_bDrawIcon;

Observações

Defina este membro para TRUE para mostrar um ícone em cada tooltip, ou FALSE para mostrar tooltips sem ícones.

CMFCToolTipInfo::m_bDrawSeparator

Especifica se cada tooltip tem um separador entre o seu rótulo e a sua descrição.

BOOL m_bDrawSeparator;

Observações

Defina este membro para TRUE para mostrar o separador entre o rótulo da tooltip e a descrição, ou FALSE para mostrar tooltips sem separador.

CMFCToolTipInfo::m_bRoundedCorners

Especifica se todas as descrições têm cantos arredondados.

BOOL m_bRoundedCorners;

Observações

Defina este elemento como TRUE para mostrar cantos arredondados nas dicas de ferramenta, ou FALSE para mostrar cantos retangulares nas dicas de ferramenta.

CMFCToolTipInfo::m_clrBorder

Especifica a cor das bordas em todas as dicas de ferramenta.

COLORREF m_clrBorder;

CMFCToolTipInfo::m_clrFill

Especifica a cor dos fundos das dicas de ferramenta.

COLORREF m_clrFill;

Observações

Se CMFCToolTipInfo::m_clrFillGradient for -1, a cor de fundo da tooltip é m_clrFill. Caso contrário, m_clrFill especifica a cor do início do gradiente e m_clrFillGradient especifica a cor do fim do gradiente. CMFCToolTipInfo::m_nGradientAngle determina a direção do gradiente.

CMFCToolTipInfo::m_clrFillGradient

Especifica a cor final para um fundo em gradiente para tooltips.

COLORREF m_clrFillGradient;

Observações

Se m_clrFillGradient for -1, não há gradiente. Caso contrário, a cor inicial do gradiente é especificada por CMFCToolTipInfo::m_clrFill e a cor de acabamento do gradiente é especificada por m_clrFillGradient. CMFCToolTipInfo::m_nGradientAngle determina a direção do gradiente.

CMFCToolTipInfo::m_clrText

Especifica a cor do texto em todas as dicas de ferramenta.

COLORREF m_clrText;

CMFCToolTipInfo::m_nGradientAngle

Especifica o ângulo em que um gradiente é desenhado no fundo das dicas de ferramenta.

int m_nGradientAngle;

Observações

m_nGradientAngle especifica o ângulo, em graus, pelo qual o gradiente no fundo das descrições de ferramentas está deslocado em relação à horizontal. Se m_nGradientAngle for 0, o gradiente é desenhado da esquerda para a direita. Se m_nGradientAngle estiver entre 1 e 360, o gradiente está a rodar no sentido dos ponteiros do relógio por esse número de graus. Se m_nGradientAngle for -1, que é o valor padrão, o gradiente é desenhado de cima para baixo. Isto é o mesmo que definir m_nGradientAngle para 90.

CMFCToolTipInfo::m_clrFillclrFill especifica a cor do início do gradiente e CMFCToolTipInfo::m_clrFillGradientclrFillGradient especifica a cor do fim do gradiente. Se m_clrFillGradient for -1, não há gradiente.

CMFCToolTipInfo::m_nMaxDescrWidth

Especifica a largura máxima da descrição que foi exibida em cada tooltip. Se a largura da descrição exceder o valor especificado, o texto é enrolado.

int m_nMaxDescrWidth;

CMFCToolTipInfo::m_bVislManagerTheme

Especifica se o gestor visual da aplicação controla a aparência de todas as dicas de ferramenta.

BOOL m_bVislManagerTheme;

Observações

Se m_bVislManagerTheme for VERDADEIRO, cada tooltip solicita um novo CMFCToolTipInfo ao gestor visual da aplicação antes de aparecer no ecrã, e usa os valores desse objeto para determinar a sua aparência. Os outros membros do seu CMFCToolTipInfo são ignorados.

CMFCToolTipInfo::operator=

Para mais detalhes, consulte o código-fonte localizado na pasta VC\atlmfc\src\mfc da sua instalação no Visual Studio.

CMFCToolTipInfo& operator=(CMFCToolTipInfo& src);

Parâmetros

[dentro] src

Valor de retorno

Observações

Consulte também

Gráfico de Hierarquia
Classes
Classe CTooltipManager
Classe CMFCToolTipCtrl