Classe CMFCLinkCtrl

A classe CMFCLinkCtrl exibe um botão como um hiperlink e invoca o destino do link quando o botão é clicado.

Sintaxe

class CMFCLinkCtrl : public CMFCButton

Membros

Métodos públicos

Nome	Descrição
CMFCLinkCtrl::SetURL	Exibe uma URL especificada como o 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 do botão ou o bitmap.

Métodos protegidos

Nome	Descrição
CMFCLinkCtrl::OnDrawFocusRect	Chamado pela estrutura antes que o retângulo de foco do botão seja desenhado.

Comentários

Quando você clica em um botão derivado da classe CMFCLinkCtrl, a estrutura passa a URL do botão como um parâmetro para o método ShellExecute. Em seguida, o método ShellExecute abre o destino da URL.

Exemplo

O exemplo a seguir demonstra como definir o tamanho de um objeto CMFCLinkCtrl e como definir uma URL e uma dica de ferramenta em um objeto CMFCLinkCtrl. Este exemplo faz parte da amostra de Novos Controles.

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

Requisitos

Cabeçalho: afxlinkctrl.h

CMFCLinkCtrl::OnDrawFocusRect

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

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

Parâmetros

pDC
[in] Um ponteiro para um contexto de dispositivo.

rectClient
[in] Um retângulo que limita o controle de link.

Comentários

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

CMFCLinkCtrl::SetURL

Exibe uma URL especificada como o texto do botão.

void SetURL(LPCTSTR lpszURL);

Parâmetros

lpszURL
[in] O texto do botão a ser exibido.

Comentários

CMFCLinkCtrl::SetURLPrefix

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

void SetURLPrefix(LPCTSTR lpszPrefix);

Parâmetros

lpszPrefix
[in] O prefixo do protocolo URL.

Comentários

Use esse método para definir o prefixo da URL. O prefixo não é exibido no rosto do botão, mas você pode usá-lo para ajudar a navegar até o destino da URL.

CMFCLinkCtrl::SizeToContent

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

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

Parâmetros

bVCenter
[in] TRUE para centralizar o texto do botão e o bitmap verticalmente entre a parte superior e inferior do controle de link; caso contrário, FALSE. O valor padrão é FALSE.

bHCenter
[in] TRUE para centralizar o texto do botão e o bitmap horizontalmente entre os lados esquerdo e direito do controle de link; caso contrário, FALSE. O valor padrão é FALSE.

Valor de retorno

Um objeto CSize que contém o novo tamanho do controle de link.

Comentários

Confira também

Gráfico da hierarquia
Classes
Classe CLinkCtrl
Classe CMFCButton