CMFCLinkCtrl Class
The CMFCLinkCtrl class displays a button as a hyperlink and invokes the link's target when the button is clicked.
class CMFCLinkCtrl : public CMFCButton
| Name | Description |
|---|---|
| CMFCLinkCtrl::SetURL | Displays a specified URL as the button text. |
| CMFCLinkCtrl::SetURLPrefix | Sets the implicit protocol (for example, "http:") of the URL. |
| CMFCLinkCtrl::SizeToContent | Resizes the button to contain the button text or bitmap. |
| Name | Description |
|---|---|
| CMFCLinkCtrl::OnDrawFocusRect | Called by the framework before the focus rectangle of the button is drawn. |
When you click a button that is derived from the CMFCLinkCtrl class, the framework passes the URL of the button as a parameter to the ShellExecute method. Then the ShellExecute method opens the target of the URL.
The following example demonstrates how to set the size of a CMFCLinkCtrl object, and how to set a url and a tooltip in a CMFCLinkCtrl object. This example is part of the New Controls sample.
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();
Header: afxlinkctrl.h
Called by the framework before the focus rectangle of the button is drawn.
virtual void OnDrawFocusRect(
CDC* pDC,
const CRect& rectClient);
pDC
[in] A pointer to a device context.
rectClient
[in] A rectangle that bounds the link control.
Override this method when you want to use your own code to draw the button's focus rectangle.
Displays a specified URL as the button text.
void SetURL(LPCTSTR lpszURL);
lpszURL
[in] The button text to display.
Sets the implicit protocol (for example, "http:") of the URL.
void SetURLPrefix(LPCTSTR lpszPrefix);
lpszPrefix
[in] The prefix of the URL protocol.
Use this method to set the URL prefix. The prefix is not displayed on the button's face, but you can use it to help browse to the URL's target.
Resizes the button to contain the button text or bitmap.
virtual CSize SizeToContent(
BOOL bVCenter=FALSE,
BOOL bHCenter=FALSE);
bVCenter
[in] TRUE to center the button text and bitmap vertically between the top and bottom of the link control; otherwise, FALSE. The default value is FALSE.
bHCenter
[in] TRUE to center the button text and bitmap horizontally between the left and right sides of the link control; otherwise, FALSE. The default value is FALSE.
A CSize object that contains the new size of the link control.