Partilhar via

Classe CMFCLinkCtrl

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.

A CMFCLinkCtrl classe apresenta um botão como hiperligação e invoca o alvo do link quando o botão é clicado.

Sintaxe

class CMFCLinkCtrl : public CMFCButton

Membros

Métodos Públicos

Nome Description
CMFCLinkCtrl::SetURL Mostra uma URL especificada como texto do botão.
CMFCLinkCtrl::SetURLPrefix Define o protocolo implícito (por exemplo, "http:") da URL.
CMFCLinkCtrl::SizeToContent Redimensiona o botão para conter o texto ou bitmap do botão.

Métodos Protegidos

Nome Description
CMFCLinkCtrl::OnDrawFocusRect Chamado pela estrutura antes de o retângulo de foco do botão ser desenhado.

Observações

Quando clica num botão derivado da CMFCLinkCtrl classe, a estrutura passa a URL do botão como parâmetro ao ShellExecute método. Depois, o ShellExecute método abre o destino da URL.

Example

O exemplo seguinte demonstra como definir o tamanho de um CMFCLinkCtrl objeto e como definir uma URL e uma dica de ferramenta num CMFCLinkCtrl objeto. Este exemplo faz parte do exemplo New Controls.

CMFCLinkCtrl m_btnLink;

m_btnLink.SetURL(_T("http://www.microsoft.com"));
m_btnLink.SetTooltip(_T("Visit Microsoft site"));
// resize the button to contain the button text or bitmap
m_btnLink.SizeToContent();

Hierarquia de herança

CObject

CCmdTarget

CWnd

CButton

CMFCButton

CMFCLinkCtrl

Requerimentos

Cabeçalho: afxlinkctrl.h

CMFCLinkCtrl::OnDrawFocusRect

Chamado pela estrutura antes de o retângulo de foco do botão ser desenhado.

virtual void OnDrawFocusRect(
    CDC* pDC,
    const CRect& rectClient);

Parâmetros

pDC
[dentro] Um apontador para o contexto de um dispositivo.

rectClient
[dentro] Um retângulo que limita o controlo da ligação.

Observações

Anule este método quando quiser usar o seu próprio código para desenhar o retângulo de foco do botão.

CMFCLinkCtrl::SetURL

Mostra uma URL especificada como texto do botão.

void SetURL(LPCTSTR lpszURL);

Parâmetros

lpszURL
[dentro] O texto do botão para mostrar.

Observações

CMFCLinkCtrl::SetURLPrefix

Define o protocolo implícito (por exemplo, "http:") da URL.

void SetURLPrefix(LPCTSTR lpszPrefix);

Parâmetros

lpszPrefixo
[dentro] O prefixo do protocolo URL.

Observações

Use este método para definir o prefixo URL. O prefixo não é mostrado na face do botão, mas pode usá-lo para ajudar a navegar até ao destino do URL.

CMFCLinkCtrl::SizeToContent

Redimensiona o botão para conter o texto ou bitmap do botão.

virtual CSize SizeToContent(
    BOOL bVCenter=FALSE,
    BOOL bHCenter=FALSE);

Parâmetros

bVCenter
[dentro] TRUE para centrar o texto do botão e o bitmap verticalmente entre o topo e o fundo do controlo de ligação; caso contrário, FALSO. O valor padrão é FALSE.

bHCenter
[dentro] TRUE para centrar o texto do botão e o bitmap horizontalmente entre os lados esquerdo e direito do controlo da ligação; caso contrário, FALSO. O valor padrão é FALSE.

Valor de retorno

Um objeto CSize que contém o novo tamanho do controlo da ligação.

Observações

Consulte também

Gráfico de Hierarquia
Classes
Classe CLinkCtrl
Classe CMFCButton

  • Last updated on