Aspose.Slides .NET:SetExternalHyperlinkMouseOver与Click的区别?
Aspose.Slides中SetExternalHyperlinkMouseOver与SetExternalHyperlinkClick的差异
这两个方法都是Aspose.Slides中用于给文本/形状绑定外部超链接的API,但核心差异在于触发时机和功能定位:
1. SetExternalHyperlinkClick
- 触发条件:仅在用户鼠标左键点击目标文本或形状时触发。
- 核心功能:实现常规的点击跳转逻辑——点击后直接打开指定的外部URL地址,是PPT中最常见的超链接使用场景。
- 代码示例:
// 获取幻灯片上的文本段落 ITextFrame textFrame = slide.Shapes.AddTextFrame("点击打开示例网站", 100, 100, 300, 50).TextFrame; IPortion textPortion = textFrame.Paragraphs[0].Portions[0]; // 设置点击跳转的外部超链接 textPortion.PortionFormat.SetExternalHyperlinkClick(new Uri("https://example.com"));
2. SetExternalHyperlinkMouseOver
- 触发条件:当用户鼠标悬停在目标文本或形状上时触发。
- 核心功能:主要用于添加工具提示(Tooltip),同时可以关联外部URL。注意:悬停本身不会直接跳转,只会显示设置的提示文本;如果关联了URL,光标会变成手型,但跳转仍需要用户点击。
- 代码示例:
// 获取幻灯片上的文本段落 ITextFrame textFrame = slide.Shapes.AddTextFrame("悬停查看提示", 100, 200, 300, 50).TextFrame; IPortion textPortion = textFrame.Paragraphs[0].Portions[0]; // 设置悬停时的超链接并绑定工具提示 IHyperlink hoverLink = textPortion.PortionFormat.SetExternalHyperlinkMouseOver(new Uri("https://example.org")); hoverLink.Tooltip = "这是鼠标悬停时显示的提示内容";
关键差异总结
| 维度 | SetExternalHyperlinkClick | SetExternalHyperlinkMouseOver |
|---|---|---|
| 触发时机 | 鼠标点击 | 鼠标悬停 |
| 核心用途 | 实现点击跳转的常规超链接 | 添加悬停工具提示,可关联超链接(跳转仍需点击) |
| 视觉反馈 | 点击后直接跳转URL | 悬停时显示Tooltip文本,光标变为手型(若绑定URL) |
内容的提问来源于stack exchange,提问作者Varsha R
相关产品推荐
相关产品推荐

