Freigeben über


CMFCRibbonLinkCtrl-Klasse

Implementiert einen Hyperlink, der auf einem Menüband positioniert wird. Wenn Sie den Hyperlink anklicken, wird eine Webseite geöffnet. Ausführliche Informationen finden Sie im Quellcode des Ordners VC\atlmfc\src\mfc der Visual Studio-Installation.

Syntax

class CMFCRibbonLinkCtrl : public CMFCRibbonButton

Member

Öffentliche Konstruktoren

Name Beschreibung
CMFCRibbonLinkCtrl::CMFCRibbonLinkCtrl Erstellt und initialisiert ein CMFCRibbonLinkCtrl-Objekt.

Öffentliche Methoden

Name Beschreibung
CMFCRibbonLinkCtrl::CopyFrom (Überschreibt CMFCRibbonButton::CopyFrom.)
CMFCRibbonLinkCtrl::GetCompactSize (Außerkraftsetzungen CMFCRibbonButton::GetCompactSize.)
CMFCRibbonLinkCtrl::GetLink Gibt den Wert des Links zurück.
CMFCRibbonLinkCtrl::GetRegularSize (Außerkraftsetzungen CMFCRibbonButton::GetRegularSize.)
CMFCRibbonLinkCtrl::GetToolTipText (Außerkraftsetzungen CMFCRibbonButton::GetToolTipText.)
CMFCRibbonLinkCtrl::IsDrawTooltipImage (Überschreibt CMFCRibbonButton::IsDrawTooltipImage.)
CMFCRibbonLinkCtrl::OnDraw (Außerkraftsetzungen CMFCRibbonButton::OnDraw.)
CMFCRibbonLinkCtrl::OnDrawMenuImage (Außerkraftsetzungen CMFCRibbonBaseElement::OnDrawMenuImage.)
CMFCRibbonLinkCtrl::OnMouseMove (Überschreibt CMFCRibbonButton::OnMouseMove.)
CMFCRibbonLinkCtrl::OnSetIcon
CMFCRibbonLinkCtrl::OpenLink Öffnet die im Link angegebene Webseite.
CMFCRibbonLinkCtrl::SetLink Legt den Wert des Links fest.

Hinweise

Nachdem Sie einen Link erstellt haben, fügen Sie ihn zu einem Panel hinzu, indem Sie CMFCRibbonPanel::Add aufrufen.

Vererbungshierarchie

CObject
└ CMFCRibbonBaseElement
└ CMFCRibbonButton
  └ CMFCRibbonLinkCtrl

Anforderungen

Header: afxRibbonLinkCtrl.h

CMFCRibbonLinkCtrl::CMFCRibbonLinkCtrl

Erstellt und initialisiert ein CMFCRibbonLinkCtrl -Objekt.

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

Parameter

Nid
[in] Gibt die Befehls-ID des Befehls an, der ausgeführt wird, wenn auf das Verknüpfungssteuerelement geklickt wird.

lpszText
[in] Gibt die Beschriftung an, die im Linksteuerelement angezeigt werden soll.

lpszLink
[in] Gibt den Hyperlink an, der dem Linksteuerelement zugeordnet ist.

Beispiel

Im folgenden Beispiel wird die Verwendung des Konstruktors der CMFCRibbonLinkCtrl Klasse veranschaulicht. Dieser Codeausschnitt ist Teil des Menüband-Gadgets-Beispiels.

// 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);

Parameter

[in] Src

Hinweise

CMFCRibbonLinkCtrl::GetCompactSize

virtual CSize GetCompactSize(CDC* pDC);

Parameter

[in] pDC

Rückgabewert

Bemerkungen

Gibt den Wert des Links zurück.

LPCTSTR GetLink() const;

Rückgabewert

Der aktuelle Wert des Hyperlinks.

Hinweise

CMFCRibbonLinkCtrl::GetRegularSize

virtual CSize GetRegularSize(CDC* pDC);

Parameter

[in] pDC

Rückgabewert

Bemerkungen

CMFCRibbonLinkCtrl::GetToolTipText

virtual CString GetToolTipText() const;

Rückgabewert

Bemerkungen

CMFCRibbonLinkCtrl::OnDrawMenuImage

virtual BOOL OnDrawMenuImage(CDC*, CRect);

Parameter

[in] CDC*
[in] CRect

Rückgabewert

Bemerkungen

CMFCRibbonLinkCtrl::IsDrawTooltipImage

virtual BOOL IsDrawTooltipImage() const;

Rückgabewert

Bemerkungen

CMFCRibbonLinkCtrl::OnDraw

virtual void OnDraw(CDC* pDC);

Parameter

[in] pDC

Hinweise

CMFCRibbonLinkCtrl::OnMouseMove

virtual void OnMouseMove(CPoint point);

Parameter

[in] Punkt

Hinweise

CMFCRibbonLinkCtrl::OnSetIcon

virtual void OnSetIcon();

Hinweise

Öffnet die im Link angegebene Webseite.

BOOL OpenLink();

Rückgabewert

TRUE, wenn die zugeordnete Webseite erfolgreich geöffnet wurde; andernfalls FALSE.

Hinweise

Öffnet eine Webseite mit dem Hyperlink, der dem CMFCRibbonLinkCtrl Objekt zugeordnet ist.

Legt den Wert des Links fest.

void SetLink(LPCTSTR lpszLink);

Parameter

lpszLink
[in] Gibt den Linktext an.

Siehe auch

Hierarchiediagramm
Klassen
CMFCRibbonButton-Klasse