CMFCRibbonLinkCtrl ClaseCMFCRibbonLinkCtrl Class

Implementa un hipervínculo que se coloca en una cinta.Implements a hyperlink that is positioned on a ribbon. El hipervínculo abre una página web cuando se hace clic en él.The hyperlink opens a Web page when you click it. Para obtener más información, vea el código fuente ubicado en la carpeta VC\atlmfc\src\mfc de la instalación de Visual Studio.For more detail see the source code located in the VC\atlmfc\src\mfc folder of your Visual Studio installation.

SintaxisSyntax

class CMFCRibbonLinkCtrl : public CMFCRibbonButton

MiembrosMembers

Constructores públicosPublic Constructors

NombreName DescripciónDescription
CMFCRibbonLinkCtrl::CMFCRibbonLinkCtrlCMFCRibbonLinkCtrl::CMFCRibbonLinkCtrl Construye e inicializa un objeto CMFCRibbonLinkCtrl.Constructs and initializes a CMFCRibbonLinkCtrl object.

Métodos públicosPublic Methods

NombreName DescripciónDescription
CMFCRibbonLinkCtrl::CopyFromCMFCRibbonLinkCtrl::CopyFrom (Invalida CMFCRibbonButton::CopyFrom).(Overrides CMFCRibbonButton::CopyFrom.)
CMFCRibbonLinkCtrl::GetCompactSizeCMFCRibbonLinkCtrl::GetCompactSize (Reemplaza CMFCRibbonButton::GetCompactSize.)(Overrides CMFCRibbonButton::GetCompactSize.)
CMFCRibbonLinkCtrl::GetLinkCMFCRibbonLinkCtrl::GetLink Devuelve el valor del hipervínculo.Returns the value of the hyperlink.
CMFCRibbonLinkCtrl::GetRegularSizeCMFCRibbonLinkCtrl::GetRegularSize (Reemplaza CMFCRibbonButton::GetRegularSize.)(Overrides CMFCRibbonButton::GetRegularSize.)
CMFCRibbonLinkCtrl::GetToolTipTextCMFCRibbonLinkCtrl::GetToolTipText (Reemplaza CMFCRibbonButton::GetToolTipText.)(Overrides CMFCRibbonButton::GetToolTipText.)
CMFCRibbonLinkCtrl::IsDrawTooltipImageCMFCRibbonLinkCtrl::IsDrawTooltipImage (Invalida CMFCRibbonButton::IsDrawTooltipImage).(Overrides CMFCRibbonButton::IsDrawTooltipImage.)
CMFCRibbonLinkCtrl::OnDrawCMFCRibbonLinkCtrl::OnDraw (Reemplaza CMFCRibbonButton::OnDraw.)(Overrides CMFCRibbonButton::OnDraw.)
CMFCRibbonLinkCtrl::OnDrawMenuImageCMFCRibbonLinkCtrl::OnDrawMenuImage (Reemplaza CMFCRibbonBaseElement::OnDrawMenuImage.)(Overrides CMFCRibbonBaseElement::OnDrawMenuImage.)
CMFCRibbonLinkCtrl::OnMouseMoveCMFCRibbonLinkCtrl::OnMouseMove (Invalida CMFCRibbonButton::OnMouseMove).(Overrides CMFCRibbonButton::OnMouseMove.)
CMFCRibbonLinkCtrl::OnSetIconCMFCRibbonLinkCtrl::OnSetIcon
CMFCRibbonLinkCtrl::OpenLinkCMFCRibbonLinkCtrl::OpenLink Se abre la página web especificada en el hipervínculo.Opens the Web page specified in the hyperlink.
CMFCRibbonLinkCtrl::SetLinkCMFCRibbonLinkCtrl::SetLink Establece el valor del hipervínculo.Sets the value of the hyperlink.

ObservacionesRemarks

Después de crear un hipervínculo, agréguelo a un panel llamando a CMFCRibbonPanel::Add.After you create a hyperlink, add it to a panel by calling CMFCRibbonPanel::Add.

Jerarquía de herenciaInheritance Hierarchy

CobjectCObject
 CMFCRibbonBaseElement└ CMFCRibbonBaseElement
     CMFCRibbonButton    └ CMFCRibbonButton
         CMFCRibbonLinkCtrl        └ CMFCRibbonLinkCtrl

RequisitosRequirements

Encabezado: afxRibbonLinkCtrl.hHeader: afxRibbonLinkCtrl.h

CMFCRibbonLinkCtrl::CMFCRibbonLinkCtrlCMFCRibbonLinkCtrl::CMFCRibbonLinkCtrl

Construye e inicializa un CMFCRibbonLinkCtrl objeto.Constructs and initializes a CMFCRibbonLinkCtrl object.

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

ParámetrosParameters

nIDnID
[en] Especifica el identificador de comando del comando que se ejecuta cuando se hace clic en el control de vínculo.[in] Specifies the command ID of the command that executes when the link control is clicked.

lpszTextlpszText
[en] Especifica la etiqueta que se mostrará en el control de vínculo.[in] Specifies the label to display on the link control.

lpszLinklpszLink
[en] Especifica el hipervínculo asociado al control de vínculo.[in] Specifies the hyperlink associated with the link control.

EjemploExample

En el ejemplo siguiente se muestra CMFCRibbonLinkCtrl cómo utilizar el constructor de la clase.The following example demonstrates how to use the constructor of the CMFCRibbonLinkCtrl class. Este fragmento de código forma parte del ejemplo Deretosde la cinta de opciones.This code snippet is part of the Ribbon Gadgets sample.

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

CMFCRibbonLinkCtrl::CopyFromCMFCRibbonLinkCtrl::CopyFrom

virtual void CopyFrom(const CMFCRibbonBaseElement& src);

ParámetrosParameters

[en] src[in] src

ObservacionesRemarks

CMFCRibbonLinkCtrl::GetCompactSizeCMFCRibbonLinkCtrl::GetCompactSize

virtual CSize GetCompactSize(CDC* pDC);

ParámetrosParameters

[en] pDC[in] pDC

Valor devueltoReturn Value

ObservacionesRemarks

Devuelve el valor del hipervínculo.Returns the value of the hyperlink.

LPCTSTR GetLink() const;

Valor devueltoReturn Value

El valor actual del hipervínculo.The current value of the hyperlink.

ObservacionesRemarks

CMFCRibbonLinkCtrl::GetRegularSizeCMFCRibbonLinkCtrl::GetRegularSize

virtual CSize GetRegularSize(CDC* pDC);

ParámetrosParameters

[en] pDC[in] pDC

Valor devueltoReturn Value

ObservacionesRemarks

CMFCRibbonLinkCtrl::GetToolTipTextCMFCRibbonLinkCtrl::GetToolTipText

virtual CString GetToolTipText() const;

Valor devueltoReturn Value

ObservacionesRemarks

CMFCRibbonLinkCtrl::OnDrawMenuImageCMFCRibbonLinkCtrl::OnDrawMenuImage

virtual BOOL OnDrawMenuImage(CDC*, CRect);

ParámetrosParameters

[en] CDC*[in] CDC*
[en] CRect[in] CRect

Valor devueltoReturn Value

ObservacionesRemarks

CMFCRibbonLinkCtrl::IsDrawTooltipImageCMFCRibbonLinkCtrl::IsDrawTooltipImage

virtual BOOL IsDrawTooltipImage() const;

Valor devueltoReturn Value

ObservacionesRemarks

CMFCRibbonLinkCtrl::OnDrawCMFCRibbonLinkCtrl::OnDraw

virtual void OnDraw(CDC* pDC);

ParámetrosParameters

[en] pDC[in] pDC

ObservacionesRemarks

CMFCRibbonLinkCtrl::OnMouseMoveCMFCRibbonLinkCtrl::OnMouseMove

virtual void OnMouseMove(CPoint point);

ParámetrosParameters

[en] punto[in] point

ObservacionesRemarks

CMFCRibbonLinkCtrl::OnSetIconCMFCRibbonLinkCtrl::OnSetIcon

virtual void OnSetIcon();

ObservacionesRemarks

Se abre la página web especificada en el hipervínculo.Opens the Web page specified in the hyperlink.

BOOL OpenLink();

Valor devueltoReturn Value

TRUESi la página web asociada se abrió correctamente; de lo contrario, FALSE.TRUE if the associated webpage was opened successfully; otherwise, FALSE.

ObservacionesRemarks

Abre una página web mediante CMFCRibbonLinkCtrl el hipervínculo asociado al objeto.Opens a webpage using the hyperlink associated with the CMFCRibbonLinkCtrl object.

Establece el valor del hipervínculo.Sets the value of the hyperlink.

void SetLink(LPCTSTR lpszLink);

ParámetrosParameters

lpszLinklpszLink
[en] Especifica el texto del hipervínculo.[in] Specifies the hyperlink text.

Vea tambiénSee also

Gráfico de jerarquíasHierarchy Chart
ClasesClasses
CMFCRibbonButton (clase)CMFCRibbonButton Class