CMFCLinkCtrl-Klasse

Die CMFCLinkCtrl Klasse zeigt eine Schaltfläche als Link an und ruft das Ziel des Links auf, wenn auf die Schaltfläche geklickt wird.

Syntax

class CMFCLinkCtrl : public CMFCButton

Member

Öffentliche Methoden

Name Beschreibung
CMFCLinkCtrl::SetURL Zeigt eine angegebene URL als Schaltflächentext an.
CMFCLinkCtrl::SetURLPrefix Legt das implizite Protokoll (z. B. "http:") der URL fest.
CMFCLinkCtrl::SizeToContent Ändert die Größe der Schaltfläche so, dass sie den Schaltflächentext oder die Bitmap enthält.

Geschützte Methoden

Name Beschreibung
CMFCLinkCtrl::OnDrawFocusRect Wird vom Framework aufgerufen, bevor das Fokusrechteck der Schaltfläche gezeichnet wird.

Hinweise

Wenn Sie auf eine Schaltfläche klicken, die von der CMFCLinkCtrl Klasse abgeleitet wird, übergibt das Framework die URL der Schaltfläche als Parameter an die ShellExecute Methode. Anschließend öffnet die ShellExecute Methode das Ziel der URL.

Beispiel

Im folgenden Beispiel wird das Festlegen der Größe eines CMFCLinkCtrl Objekts und das Festlegen einer URL und einer QuickInfo in einem CMFCLinkCtrl Objekt veranschaulicht. Dieses Beispiel ist Teil des Beispiels "Neue Steuerelemente".

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

Vererbungshierarchie

CObject

CCmdTarget

CWnd

CButton

CMFCButton

CMFCLinkCtrl

Anforderungen

Header: afxlinkctrl.h

CMFCLinkCtrl::OnDrawFocusRect

Wird vom Framework aufgerufen, bevor das Fokusrechteck der Schaltfläche gezeichnet wird.

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

Parameter

pDC
[in] Ein Zeiger auf einen Gerätekontext.

rectClient
[in] Ein Rechteck, das das Verknüpfungssteuerelement begrenzt.

Hinweise

Überschreiben Sie diese Methode, wenn Sie ihren eigenen Code verwenden möchten, um das Fokusrechteck der Schaltfläche zu zeichnen.

CMFCLinkCtrl::SetURL

Zeigt eine angegebene URL als Schaltflächentext an.

void SetURL(LPCTSTR lpszURL);

Parameter

lpszURL
[in] Der anzuzeigende Schaltflächentext.

Hinweise

CMFCLinkCtrl::SetURLPrefix

Legt das implizite Protokoll (z. B. "http:") der URL fest.

void SetURLPrefix(LPCTSTR lpszPrefix);

Parameter

lpszPrefix
[in] Das Präfix des URL-Protokolls.

Hinweise

Verwenden Sie diese Methode, um das URL-Präfix festzulegen. Das Präfix wird nicht im Gesicht der Schaltfläche angezeigt, Sie können es jedoch verwenden, um zum Ziel der URL zu navigieren.

CMFCLinkCtrl::SizeToContent

Ändert die Größe der Schaltfläche so, dass sie den Schaltflächentext oder die Bitmap enthält.

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

Parameter

bVCenter
[in] TRUE, um den Schaltflächentext und die Bitmap vertikal zwischen dem oberen und unteren Rand des Verknüpfungssteuerelements zu zentrieren; andernfalls FALSE. Der Standardwert ist FALSCH.

bHCenter
[in] TRUE, um den Schaltflächentext und die Bitmap horizontal zwischen der linken und rechten Seite des Verknüpfungssteuerelements zu zentrieren; andernfalls FALSE. Der Standardwert ist FALSCH.

Rückgabewert

Ein CSize-Objekt, das die neue Größe des Verknüpfungssteuerelements enthält.

Hinweise

Weitere Informationen

Hierarchiediagramm
Klassen
CLinkCtrl-Klasse
CMFCButton-Klasse