通过

CMFCRibbonLinkCtrl 类

  • 项目

实现位于功能区上的超链接。 当单击此超链接时，可以打开网页。 有关详细信息，请参阅所安装的 Visual Studio 的 C\atlmfc\src\mfc 文件夹中的源代码。

语法

class CMFCRibbonLinkCtrl : public CMFCRibbonButton

成员

公共构造函数

名称 描述
CMFCRibbonLinkCtrl::CMFCRibbonLinkCtrl 构造并初始化一个 CMFCRibbonLinkCtrl 对象。

公共方法

名称 描述
CMFCRibbonLinkCtrl::CopyFrom （替代 CMFCRibbonButton::CopyFrom。）
CMFCRibbonLinkCtrl::GetCompactSize （重写 CMFCRibbonButton::GetCompactSize。）
CMFCRibbonLinkCtrl::GetLink 返回超链接的值。
CMFCRibbonLinkCtrl::GetRegularSize （重写 CMFCRibbonButton::GetRegularSize。）
CMFCRibbonLinkCtrl::GetToolTipText （重写 CMFCRibbonButton::GetToolTipText。）
CMFCRibbonLinkCtrl::IsDrawTooltipImage （替代 CMFCRibbonButton::IsDrawTooltipImage。）
CMFCRibbonLinkCtrl::OnDraw （重写 CMFCRibbonButton::OnDraw。）
CMFCRibbonLinkCtrl::OnDrawMenuImage （重写 CMFCRibbonBaseElement::OnDrawMenuImage。）
CMFCRibbonLinkCtrl::OnMouseMove （替代 CMFCRibbonButton::OnMouseMove。）
CMFCRibbonLinkCtrl::OnSetIcon
CMFCRibbonLinkCtrl::OpenLink 将打开超链接中指定的 Web 页。
CMFCRibbonLinkCtrl::SetLink 设置超链接的值。

备注

创建超链接后，通过调用 CMFCRibbonPanel::Add 将其添加到面板。

继承层次结构

CObject
└ CMFCRibbonBaseElement
 └ CMFCRibbonButton
  └ CMFCRibbonLinkCtrl

要求

标头：afxRibbonLinkCtrl.h

CMFCRibbonLinkCtrl::CMFCRibbonLinkCtrl

构造并初始化 CMFCRibbonLinkCtrl 对象。

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

参数

nID
[in] 指定单击链接控件时执行的命令的命令 ID。

lpszText
[in] 指定要在链接控件上显示的标签。

lpszLink
[in] 指定与链接控件关联的超链接。

示例

以下示例演示了如何使用 CMFCRibbonLinkCtrl 类的构造函数。 此代码片段属于 Ribbon Gadgets 示例。

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

参数

[in] src

备注

CMFCRibbonLinkCtrl::GetCompactSize

virtual CSize GetCompactSize(CDC* pDC);

参数

[in] pDC

返回值

备注

返回超链接的值。

LPCTSTR GetLink() const;

返回值

当前的超链接值。

备注

CMFCRibbonLinkCtrl::GetRegularSize

virtual CSize GetRegularSize(CDC* pDC);

参数

[in] pDC

返回值

注解

CMFCRibbonLinkCtrl::GetToolTipText

virtual CString GetToolTipText() const;

返回值

备注

CMFCRibbonLinkCtrl::OnDrawMenuImage

virtual BOOL OnDrawMenuImage(CDC*, CRect);

参数

[in] CDC*
[in] CRect

返回值

注解

CMFCRibbonLinkCtrl::IsDrawTooltipImage

virtual BOOL IsDrawTooltipImage() const;

返回值

备注

CMFCRibbonLinkCtrl::OnDraw

virtual void OnDraw(CDC* pDC);

参数

[in] pDC

注解

CMFCRibbonLinkCtrl::OnMouseMove

virtual void OnMouseMove(CPoint point);

参数

[in] point

备注

CMFCRibbonLinkCtrl::OnSetIcon

virtual void OnSetIcon();

备注

将打开超链接中指定的 Web 页。

BOOL OpenLink();

返回值

如果已成功打开关联的网页，为 TRUE；否则为 FALSE。

备注

使用与 CMFCRibbonLinkCtrl 对象关联的超链接打开网页。

设置超链接的值。

void SetLink(LPCTSTR lpszLink);

参数

lpszLink
[in] 指定超链接文本。

另请参阅

层次结构图
类
CMFCRibbonButton 类