CMFCLinkCtrl 类

CMFCLinkCtrl 类将按钮显示为超链接,并在单击按钮时调用链接的目标。

语法

class CMFCLinkCtrl : public CMFCButton

成员

公共方法

名称 描述
CMFCLinkCtrl::SetURL 将指定的 URL 显示为按钮文本。
CMFCLinkCtrl::SetURLPrefix 设置 URL 的隐式协议(例如“http:”)。
CMFCLinkCtrl::SizeToContent 重设按钮的大小以包含按钮文本或位图。

受保护方法

名称 描述
CMFCLinkCtrl::OnDrawFocusRect 在绘制按钮的焦点矩形之前由框架调用。

注解

单击从 CMFCLinkCtrl 类派生的按钮时,框架会将按钮的 URL 作为参数传递给 ShellExecute 方法。 然后 ShellExecute 方法打开 URL 的目标。

示例

以下示例演示如何设置 CMFCLinkCtrl 对象的大小,以及如何在 CMFCLinkCtrl 对象中设置 URL 和工具提示。 本示例是新控件示例的一部分。

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

继承层次结构

CObject

CCmdTarget

CWnd

CButton

CMFCButton

CMFCLinkCtrl

要求

头文件:afxlinkctrl.h

CMFCLinkCtrl::OnDrawFocusRect

在绘制按钮的焦点矩形之前由框架调用。

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

参数

pDC
[in] 指向设备上下文的指针。

rectClient
[in] 绑定链接控件的矩形。

注解

想使用自己的代码来绘制按钮的焦点矩形时,请重写此方法。

CMFCLinkCtrl::SetURL

将指定的 URL 显示为按钮文本。

void SetURL(LPCTSTR lpszURL);

参数

lpszURL
[in] 要显示的按钮文本。

注解

CMFCLinkCtrl::SetURLPrefix

设置 URL 的隐式协议(例如“http:”)。

void SetURLPrefix(LPCTSTR lpszPrefix);

参数

lpszPrefix
[in] URL 协议的前缀。

注解

使用此方法设置 URL 前缀。 前缀不会显示在按钮的正面,但可使用它来帮助浏览到 URL 的目标。

CMFCLinkCtrl::SizeToContent

重设按钮的大小以包含按钮文本或位图。

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

参数

bVCenter
[in] 要在链接控件的顶部和底部之间垂直居中按钮文本和位图时,为 TRUE;否则为 FALSE。 默认值是 FALSE。

bHCenter
[in] 要将按钮文本和位图水平居中于链接控件的左右两侧时,为 TRUE;否则为 FALSE。 默认值是 FALSE。

返回值

包含链接控件的新大小的 CSize 对象。

备注

另请参阅

层次结构图

CLinkCtrl 类
CMFCButton 类