Hyperlink Class

提供一个内联级别的内容元素,该元素提供用于承载超链接的功能。

继承

Object
  DependencyObject
    TextElement
      Inline
        Span
          Hyperlink

语法


Public NotInheritable Class Hyperlink
    Inherits Span


<Hyperlink .../>

特性

[MarshalingBehavior(Agile)]
[Threading(Both)]
[Version(0x06030000)]
[WebHostHidden()]

成员

Hyperlink类 具有这些类型的成员:

构造函数

Hyperlink类 具有这些构造函数。

构造函数说明
Hyperlink Initializes a new instance of the Hyperlink class.

 

事件

Hyperlink类 具有这些事件。

事件说明
Click Occurs when the Hyperlink is clicked.

 

方法

The Hyperlink 类 具有这些方法。 它还继承方法于Object 类.

方法说明
ClearValue Clears the local value of a dependency property. (继承自DependencyObject)
FindName Retrieves an object in the object model / runtime object graph by referencing the object's x:Name or Name attribute value. (继承自TextElement)
GetAnimationBaseValue Returns any base value established for a dependency property, which would apply in cases where an animation is not active. (继承自DependencyObject)
GetValue Returns the current effective value of a dependency property from a DependencyObject. (继承自DependencyObject)
OnDisconnectVisualChildren Override this method to implement how layout and logic should behave when items are removed from a class-specific content or child property. (继承自TextElement)
ReadLocalValue Returns the local value of a dependency property, if a local value is set. (继承自DependencyObject)
SetValue Sets the local value of a dependency property on a DependencyObject. (继承自DependencyObject)

 

属性

Hyperlink类 具有这些属性。

属性访问类型说明

CharacterSpacing

读/写Gets or sets the uniform spacing between characters, in units of 1/1000 of an em. (继承自TextElement)

ContentEnd

只读Gets a TextPointer that represents the end of the content in the element. (继承自TextElement)

ContentStart

只读Gets a TextPointer that represents the start of content in the element. (继承自TextElement)

Dispatcher

只读Gets the CoreDispatcher that this object is associated with. (继承自DependencyObject)

ElementEnd

只读Gets a TextPointer that represents the position just after the end of the element. (继承自TextElement)

ElementStart

只读Gets a TextPointer that represents the position just before the start of the element. (继承自TextElement)

FontFamily

读/写Gets or sets the preferred top-level font family for the content of the element. (继承自TextElement)

FontSize

读/写Gets or sets the font size for the content of the element. (继承自TextElement)

FontStretch

读/写Gets or sets the glyph width of the font in a family to select. (继承自TextElement)

FontStyle

读/写Gets or sets the font style for the content in this element. (继承自TextElement)

FontWeight

读/写Gets or sets the top-level font weight to select from the font family for the content in this element. (继承自TextElement)

Foreground

读/写Gets or sets the Brush to apply to the content in this element. (继承自TextElement)

Inlines

读/写Gets an InlineCollection containing the top-level inline elements that include the contents of Span. (继承自Span)

Language

读/写Gets or sets localization/globalization language information that applies to a TextElement. (继承自TextElement)

Name

只读Gets or sets a unique identification for the object. Name can only be set from initial parsing of XAML. (继承自TextElement)

NavigateUri

读/写Gets or sets the Uniform Resource Identifier (URI) to navigate to when the Hyperlink is activated.

NavigateUriProperty

只读Identifies the NavigateUri dependency property.

 

备注

Hyperlink 元素是 Inline 派生类。这意味着可将信息放入 InlineCollection。它应为 RichTextBlockRichEditBox 的文本内容的一部分,但位于其他文本容器内。例如,XAML 中的 Hyperlink 对象元素可以是 Paragraph 的内容中的元素之一,在这种情况下,XAML 内容成为了 ParagraphInlines XAML 内容属性的隐式 InlineCollection 的一部分。Hyperlink 还可以位于 Span 容器中。

您设置的用于指定 Hyperlink 的导航目标的属性/特性是 NavigateUri。当用户点击已单击的 Hyperlink 元素时,NavigateUri 的值将传递到统一资源标识符 (URI) 类型和方案的系统处理程序。之后系统将启动为针对 NavigateUri 提供的 URI 的架构注册的应用程序。

由于 Hyperlink 不是 UIElement,因此它没有 UI 元素输入事件(如 TappedPointerPressed,等等)集。相反,Hyperlink 具有自己的 Click 事件。系统处理应在响应中调用 Hyperlink 操作并激发 Click 的所有输入操作。

超链接和主题/样式行为

Hyperlink 没有 Style 属性,因为前者具有不包含 FrameworkElement 的类继承。Hyperlink 也没有 Template(它不是真正的控件)。您可编辑继承自 TextElement 的属性(如 ForegroundFontFamily)以更改 Hyperlink 的外观,但您不能使用通用样式或模板来应用更改。如果您使用默认值以外的属性值,则可以考虑对 Hyperlink 属性的值使用公共资源向 Hyperlink 属性值提供一些一致性。Hyperlink 的某些属性(如 Foreground)使用系统提供的 ThemeResource 值中的默认值。这将在用户在运行时更改系统主题时以适当方式实现 Hyperlink 外观的切换。

HyperlinkHyperlinkButton

HyperlinkHyperlinkButton 具有类似的用途,即让用户能够使用单独的浏览器应用程序启动特定 URI。它们的区别在于 Hyperlink 是可放在格式化文本中(例如,RichTextBlock 中)的文本元素,而 HyperlinkButton 是可放在接受 UI 元素和控件的任何布局容器中的控件。HyperlinkButton 可能在用于支持 Web 浏览体验的自定义控件的复合/模板中使用。

要求

最低支持客户端

Windows 8.1 [仅 Windows 应用商店应用程序]

最低支持服务器

Windows Server 2012 R2 [仅 Windows 应用商店应用程序]

命名空间

Windows.UI.Xaml.Documents
Windows::UI::Xaml::Documents [C++]

元数据

Windows.winmd

另请参见

Span

 

 

显示:
© 2015 Microsoft