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
返回值
备注
CMFCRibbonLinkCtrl::GetLink
返回超链接的值。
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();
备注
CMFCRibbonLinkCtrl::OpenLink
将打开超链接中指定的 Web 页。
BOOL OpenLink();
返回值
如果已成功打开关联的网页，为 TRUE；否则为 FALSE。
备注
使用与 CMFCRibbonLinkCtrl 对象关联的超链接打开网页。
CMFCRibbonLinkCtrl::SetLink
设置超链接的值。
void SetLink(LPCTSTR lpszLink);
参数
lpszLink
[in] 指定超链接文本。