Compartilhar via


Classe CMFCRibbonLinkCtrl

Implementa um hiperlink posicionado em uma faixa de opções. O hiperlink abre uma página da Web quando você clica nela. Para obter mais detalhes, confira o código-fonte localizado na pasta VC\atlmfc\src\mfc de sua instalação do Visual Studio.

Sintaxe

class CMFCRibbonLinkCtrl : public CMFCRibbonButton

Membros

Construtores públicos

Nome Descrição
CMFCRibbonLinkCtrl::CMFCRibbonLinkCtrl Constrói e inicializa um objeto CMFCRibbonLinkCtrl.

Métodos públicos

Nome Descrição
CMFCRibbonLinkCtrl::CopyFrom (Substitui CMFCRibbonButton::CopyFrom.)
CMFCRibbonLinkCtrl::GetCompactSize (Overrides CMFCRibbonButton::GetCompactSize.)
CMFCRibbonLinkCtrl::GetLink Retorna o valor do hiperlink.
CMFCRibbonLinkCtrl::GetRegularSize (Substitui CMFCRibbonButton::GetRegularSize.)
CMFCRibbonLinkCtrl::GetToolTipText (Substitui CMFCRibbonButton::GetToolTipText.)
CMFCRibbonLinkCtrl::IsDrawTooltipImage (Substitui CMFCRibbonButton::IsDrawTooltipImage.)
CMFCRibbonLinkCtrl::OnDraw (Substitui CMFCRibbonButton::OnDraw.)
CMFCRibbonLinkCtrl::OnDrawMenuImage (Overrides CMFCRibbonBaseElement::OnDrawMenuImage.)
CMFCRibbonLinkCtrl::OnMouseMove (Substitui CMFCRibbonButton::OnMouseMove.)
CMFCRibbonLinkCtrl::OnSetIcon
CMFCRibbonLinkCtrl::OpenLink Abre a página da Web especificada no hiperlink.
CMFCRibbonLinkCtrl::SetLink Define o valor do hiperlink.

Comentários

Depois de criar um hiperlink, adicione-o a um painel chamando CMFCRibbonPanel::Add.

Hierarquia de herança

CObject
CMFCRibbonBaseElement
 └ CMFCRibbonButton
  └ CMFCRibbonLinkCtrl

Requisitos

Cabeçalho: afxRibbonLinkCtrl.h

CMFCRibbonLinkCtrl::CMFCRibbonLinkCtrl

Constrói e inicializa um objeto CMFCRibbonLinkCtrl.

CMFCRibbonLinkCtrl(
    UINT nID,
    LPCTSTR lpszText,
    LPCTSTR lpszLink);

Parâmetros

Nid
[in] Especifica a ID de comando do comando executado quando o controle de link é clicado.

lpszTexto
[in] Especifica a etiqueta a ser exibida no controle de link.

lpszLink
[in] Especifica o hiperlink associado ao controle de link.

Exemplo

O exemplo a seguir demonstra como usar o construtor da classe CMFCRibbonLinkCtrl. Este snippet de código faz parte do Exemplo de Gadgets da Faixa de Opções.

// CMFCRibbonPanel* pPanel3
pPanel3->Add(new CMFCRibbonLinkCtrl(ID_RIBBON_OBTN_2, _T("Send e-mail"), _T("mailto:info@microsoft.com")));

CMFCRibbonLinkCtrl::CopyFrom

virtual void CopyFrom(const CMFCRibbonBaseElement& src);

Parâmetros

[in] src

Comentários

CMFCRibbonLinkCtrl::GetCompactSize

virtual CSize GetCompactSize(CDC* pDC);

Parâmetros

[in] pDC

Valor de retorno

Comentários

Retorna o valor do hiperlink.

LPCTSTR GetLink() const;

Valor de retorno

O valor atual do hiperlink.

Comentários

CMFCRibbonLinkCtrl::GetRegularSize

virtual CSize GetRegularSize(CDC* pDC);

Parâmetros

[in] pDC

Valor de retorno

Comentários

CMFCRibbonLinkCtrl::GetToolTipText

virtual CString GetToolTipText() const;

Valor de retorno

Comentários

CMFCRibbonLinkCtrl::OnDrawMenuImage

virtual BOOL OnDrawMenuImage(CDC*, CRect);

Parâmetros

[in] CDC*
[in] CRect

Valor de retorno

Comentários

CMFCRibbonLinkCtrl::IsDrawTooltipImage

virtual BOOL IsDrawTooltipImage() const;

Valor de retorno

Comentários

CMFCRibbonLinkCtrl::OnDraw

virtual void OnDraw(CDC* pDC);

Parâmetros

[in] pDC

Comentários

CMFCRibbonLinkCtrl::OnMouseMove

virtual void OnMouseMove(CPoint point);

Parâmetros

[in] point

Comentários

CMFCRibbonLinkCtrl::OnSetIcon

virtual void OnSetIcon();

Comentários

Abre a página da Web especificada no hiperlink.

BOOL OpenLink();

Valor de retorno

TRUE se a página da Web associada tiver sido aberta com êxito; caso contrário, FALSE.

Comentários

Abre uma página da Web usando o hiperlink associado ao objeto CMFCRibbonLinkCtrl.

Define o valor do hiperlink.

void SetLink(LPCTSTR lpszLink);

Parâmetros

lpszLink
[in] Especifica o texto do hiperlink.

Confira também

Gráfico da hierarquia
Classes
Classe CMFCRibbonButton