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 FALSE.

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 FALSE.

Rückgabewert

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

Hinweise

Siehe auch

Hierarchiediagramm
Klassen
CLinkCtrl-Klasse
CMFCButton-Klasse