Hyperlink 类
定义
重要
一些信息与预发行产品相关，相应产品在发行之前可能会进行重大修改。 对于此处提供的信息，Microsoft 不作任何明示或暗示的担保。
内联级流内容元素，提供用于在流内容中托管超链接的工具。
public ref class Hyperlink : System::Windows::Documents::Span, System::Windows::Input::ICommandSource, System::Windows::Markup::IUriContext[System.Windows.Documents.TextElementEditingBehavior(IsMergeable=false, IsTypographicOnly=false)]
public class Hyperlink : System.Windows.Documents.Span, System.Windows.Input.ICommandSource, System.Windows.Markup.IUriContext[<System.Windows.Documents.TextElementEditingBehavior(IsMergeable=false, IsTypographicOnly=false)>]
type Hyperlink = class
inherit Span
interface ICommandSource
interface IUriContextPublic Class Hyperlink
Inherits Span
Implements ICommandSource, IUriContext- 继承
- 属性
- 实现
示例
以下示例演示如何简单使用 Hyperlink 元素。
<Paragraph>
<Run>Text preceding the hyperlink.</Run>
<Hyperlink
NavigateUri="http://search.msn.com"
>
Link text.
</Hyperlink>
<Run Name="test">Text following the hyperlink.</Run>
</Paragraph>
以下示例演示如何以编程方式创建 Hyperlink。
Paragraph parx = new Paragraph();
Run run1 = new Run("Text preceding the hyperlink.");
Run run2 = new Run("Text following the hyperlink.");
Run run3 = new Run("Link Text.");
Hyperlink hyperl = new Hyperlink(run3);
hyperl.NavigateUri = new Uri("http://search.msn.com");
parx.Inlines.Add(run1);
parx.Inlines.Add(hyperl);
parx.Inlines.Add(run2);
Dim parx As New Paragraph()
Dim run1 As New Run("Text preceeding the hyperlink.")
Dim run2 As New Run("Text following the hyperlink.")
Dim run3 As New Run("Link Text.")
Dim hyperl As New Hyperlink(run3)
hyperl.NavigateUri = New Uri("http://search.msn.com")
parx.Inlines.Add(run1)
parx.Inlines.Add(hyperl)
parx.Inlines.Add(run2)
注解
Hyperlink 实现使用单击超链接时应导航到的内容 Uri 设置的 NavigateUri 属性。 但是，仅当 Hyperlink 的直接或间接父级是导航主机（包括 NavigationWindow、Frame或任何可以托管 XBAP 的浏览器）时，才会发生 Hyperlink 导航。 有关详细信息，请参阅 导航概述中的 导航主机 主题。
Hyperlink 为子内容强制实施强内容模型。 有关 Hyperlink 内容模型的详细信息，请参阅 TextElement 内容模型概述。
此控件的依赖属性可能由控件的默认样式设置。 如果属性是按默认样式设置的，则当控件出现在应用程序中时，该属性可能会从其默认值更改。 默认样式取决于应用程序运行时使用哪个桌面主题。
构造函数
| Hyperlink() |
初始化 Hyperlink 类的新默认实例。 |
| Hyperlink(Inline, TextPointer) |
初始化 Hyperlink 类的新实例，将指定的 Inline 对象作为新 Hyperlink的初始内容，以及指定新 Hyperlink插入位置的 TextPointer。 |
| Hyperlink(Inline) | |
| Hyperlink(TextPointer, TextPointer) |
初始化 Hyperlink 类的新实例，采用两个 TextPointer 对象，这些对象指示新 Hyperlink要包含的内容的开始和结尾。 |
字段
| ClickEvent |
标识 Click 路由事件。 |
| CommandParameterProperty |
标识 CommandParameter 依赖属性。 |
| CommandProperty |
标识 Command 依赖属性。 |
| CommandTargetProperty |
标识 CommandTarget 依赖属性。 |
| NavigateUriProperty |
标识 NavigateUri 依赖属性。 |
| RequestNavigateEvent |
标识 RequestNavigate 路由事件。 |
| TargetNameProperty |
标识 TargetName 依赖属性。 |
属性
| AllowDrop |
获取或设置一个值，该值指示此元素是否可以用作拖放操作的目标。 (继承自 ContentElement) |
| AreAnyTouchesCaptured |
获取一个值，该值指示是否至少捕获到此元素的一个触摸。 (继承自 ContentElement) |
| AreAnyTouchesCapturedWithin |
获取一个值，该值指示是否至少捕获一个触摸到此元素或其可视化树中的任何子元素。 (继承自 ContentElement) |
| AreAnyTouchesDirectlyOver |
获取一个值，该值指示是否在此元素上按下至少一次触摸。 (继承自 ContentElement) |
| AreAnyTouchesOver |
获取一个值，该值指示是否在该元素或其可视化树中的任何子元素上按下至少一个触摸。 (继承自 ContentElement) |
| Background |
获取或设置用于填充内容区域背景的画笔。 (继承自 TextElement) |
| BaselineAlignment |
获取或设置 Inline 元素的基线对齐方式。 (继承自 Inline) |
| BaseUri |
获取或设置 Hyperlink的基 URI。 |
| BindingGroup |
获取或设置用于元素的 BindingGroup。 (继承自 FrameworkContentElement) |
| Command |
获取或设置与 Hyperlink关联的命令。 |
| CommandBindings |
获取与此元素关联的 CommandBinding 对象的集合。 (继承自 ContentElement) |
| CommandParameter |
获取或设置与 Command 属性指定的命令关联的命令参数。 |
| CommandTarget |
获取或设置要对其执行由 Command 属性指定的命令的目标元素。 |
| ContentEnd |
获取一个文本指针，该指针表示元素中内容的末尾。 (继承自 TextElement) |
| ContentStart |
获取一个文本指针，该指针表示元素中内容的开始。 (继承自 TextElement) |
| ContextMenu |
获取或设置上下文菜单元素，该元素应在通过用户界面（UI）从此元素中请求上下文菜单时显示。 (继承自 FrameworkContentElement) |
| Cursor |
获取或设置当鼠标指针位于此元素上时显示的光标。 (继承自 FrameworkContentElement) |
| DataContext |
获取或设置元素参与数据绑定时的数据上下文。 (继承自 FrameworkContentElement) |
| DefaultStyleKey |
获取或设置用于在主题中查找此控件的样式模板的键。 (继承自 FrameworkContentElement) |
| DependencyObjectType |
获取包装此实例的 CLR 类型的 DependencyObjectType。 (继承自 DependencyObject) |
| Dispatcher |
获取与此 DispatcherObject 关联的 Dispatcher。 (继承自 DispatcherObject) |
| ElementEnd |
获取一个文本指针，该指针表示元素末尾之后的位置。 (继承自 TextElement) |
| ElementStart |
获取一个文本指针，该指针表示元素开头前的位置。 (继承自 TextElement) |
| FlowDirection |
获取或设置一个值，该值指定 Inline 元素中内容流的相对方向。 (继承自 Inline) |
| Focusable |
获取或设置一个值，该值指示元素是否可以接收焦点。 (继承自 ContentElement) |
| FocusVisualStyle |
获取或设置一个对象，该对象用于自定义在捕获键盘焦点时将应用于此元素的外观、效果或其他样式特征。 (继承自 FrameworkContentElement) |
| FontFamily |
获取或设置元素内容的首选顶级字体系列。 (继承自 TextElement) |
| FontSize |
获取或设置元素内容的字号。 (继承自 TextElement) |
| FontStretch |
获取或设置元素内容的字体拉伸特征。 (继承自 TextElement) |
| FontStyle |
获取或设置元素内容的字体样式。 (继承自 TextElement) |
| FontWeight |
获取或设置元素内容的顶级字体粗细。 (继承自 TextElement) |
| ForceCursor |
获取或设置一个值，该值指示此 FrameworkContentElement 是否应强制用户界面（UI）呈现由此实例的 Cursor 属性声明的游标。 (继承自 FrameworkContentElement) |
| Foreground |
获取或设置要应用于元素内容的画笔。 (继承自 TextElement) |
| HasAnimatedProperties |
获取一个值，该值指示此元素是否具有任何动画属性。 (继承自 ContentElement) |
| Inlines |
获取一个 InlineCollection，其中包含构成 Span内容的顶级 Inline 元素。 (继承自 Span) |
| InputBindings |
获取与此元素关联的输入绑定的集合。 (继承自 ContentElement) |
| InputScope |
获取或设置此 FrameworkContentElement使用的输入的上下文。 (继承自 FrameworkContentElement) |
| IsEnabled |
获取或设置一个值，该值指示是否在用户界面（UI）中启用此元素。 (继承自 ContentElement) |
| IsEnabledCore |
获取一个值，该值指示是否启用 Hyperlink。 |
| IsFocused |
获取一个值，该值确定此元素是否具有逻辑焦点。 (继承自 ContentElement) |
| IsInitialized |
获取一个值，该值指示此元素是否已初始化，要么加载为可扩展应用程序标记语言（XAML），要么显式调用其 EndInit() 方法。 (继承自 FrameworkContentElement) |
| IsInputMethodEnabled |
获取一个值，该值指示是否启用了输入法系统（如输入法编辑器（IME）来处理此元素的输入。 (继承自 ContentElement) |
| IsKeyboardFocused |
获取一个值，该值指示此元素是否具有键盘焦点。 (继承自 ContentElement) |
| IsKeyboardFocusWithin |
获取一个值，该值指示键盘焦点是元素或子元素中的任意位置。 (继承自 ContentElement) |
| IsLoaded |
获取一个值，该值指示是否已加载此元素以供演示。 (继承自 FrameworkContentElement) |
| IsMouseCaptured |
获取一个值，该值指示鼠标是否由此元素捕获。 (继承自 ContentElement) |
| IsMouseCaptureWithin |
获取一个值，该值确定鼠标捕获是由此元素还是由其元素树中的子元素保存。 (继承自 ContentElement) |
| IsMouseDirectlyOver |
获取一个值，该值指示鼠标指针的位置是否对应于命中测试结果，这将考虑元素组合。 (继承自 ContentElement) |
| IsMouseOver |
获取一个值，该值指示鼠标指针是否位于此元素上（包括视觉子元素或其控件组合）。 (继承自 ContentElement) |
| IsSealed |
获取一个值，该值指示此实例当前是否密封（只读）。 (继承自 DependencyObject) |
| IsStylusCaptured |
获取一个值，该值指示是否将触笔捕获到此元素。 (继承自 ContentElement) |
| IsStylusCaptureWithin |
获取一个值，该值确定触笔捕获是否由此元素保存，包括子元素和控制组合。 (继承自 ContentElement) |
| IsStylusDirectlyOver |
获取一个值，该值指示触笔位置是否对应于命中测试结果，这将考虑元素组合。 (继承自 ContentElement) |
| IsStylusOver |
获取一个值，该值指示触笔是否位于此元素上（包括可视子元素）。 (继承自 ContentElement) |
| Language |
获取或设置应用于单个元素的本地化/全球化语言信息。 (继承自 FrameworkContentElement) |
| LogicalChildren |
获取一个枚举器，该枚举器可以循环访问元素的逻辑子级。 (继承自 TextElement) |
| Name |
获取或设置元素的标识名称。 该名称提供实例引用，以便编程代码隐藏（如事件处理程序代码）可以在分析 XAML 期间构造元素后引用元素。 (继承自 FrameworkContentElement) |
| NavigateUri |
获取或设置在激活 Hyperlink 时导航到的 URI。 |
| NextInline |
获取作为此元素对等的下一个 Inline 元素。 (继承自 Inline) |
| OverridesDefaultStyle |
获取或设置一个值，该值指示此元素是否包含主题样式中的样式属性。 (继承自 FrameworkContentElement) |
| Parent |
获取此元素的逻辑树中的父级。 (继承自 FrameworkContentElement) |
| PreviousInline |
获取与此元素对等的上一个 Inline 元素。 (继承自 Inline) |
| Resources |
获取或设置当前本地定义的资源字典。 (继承自 FrameworkContentElement) |
| SiblingInlines |
获取一个 InlineCollection，该 Inline 元素是同级元素（对等元素）。 (继承自 Inline) |
| Style |
获取或设置此元素要使用的样式。 (继承自 FrameworkContentElement) |
| Tag |
获取或设置可用于存储有关此元素的自定义信息的任意对象值。 (继承自 FrameworkContentElement) |
| TargetName |
获取或设置 Hyperlink的目标窗口或框架的名称。 |
| TemplatedParent |
获取对此元素的模板父级的引用。 如果未通过模板创建元素，则此属性不相关。 (继承自 FrameworkContentElement) |
| TextDecorations |
获取一个 TextDecorationCollection，其中包含要应用于此元素的文本修饰。 (继承自 Inline) |
| TextEffects |
获取或设置要应用于元素内容的文本效果的集合。 (继承自 TextElement) |
| ToolTip |
获取或设置用户界面 （UI） 中为此元素显示的工具提示对象。 (继承自 FrameworkContentElement) |
| TouchesCaptured |
获取捕获到此元素的所有触摸设备。 (继承自 ContentElement) |
| TouchesCapturedWithin |
获取捕获到此元素的所有触摸设备或其可视化树中的任何子元素。 (继承自 ContentElement) |
| TouchesDirectlyOver |
获取此元素上的所有触摸设备。 (继承自 ContentElement) |
| TouchesOver |
获取位于此元素上的所有触摸设备或其可视化树中的任何子元素。 (继承自 ContentElement) |
| Typography |
获取元素内容的当前有效版式变体。 (继承自 TextElement) |
方法
事件
显式接口实现
| IAddChild.AddChild(Object) |
添加子对象。 (继承自 TextElement) |
| IAddChild.AddText(String) |
将节点的文本内容添加到对象。 (继承自 TextElement) |
| IQueryAmbient.IsAmbientPropertyAvailable(String) |
有关此成员的说明，请参阅 IsAmbientPropertyAvailable(String) 方法。 (继承自 FrameworkContentElement) |
| IUriContext.BaseUri |
获取或设置 Hyperlink的基 URI。 |
