Span 类

定义

命名空间:

Windows.UI.Xaml.Documents

对其他 内联 内容元素进行分组。 Bold、Hyperlink、Italic 和 Underline 的父类。

/// [Windows.Foundation.Metadata.ContractVersion(Windows.Foundation.UniversalApiContract, 65536)]
/// [Windows.Foundation.Metadata.MarshalingBehavior(Windows.Foundation.Metadata.MarshalingType.Agile)]
/// [Windows.Foundation.Metadata.Threading(Windows.Foundation.Metadata.ThreadingModel.Both)]
/// [Windows.UI.Xaml.Markup.ContentProperty(Name="Inlines")]
class Span : Inline

[Windows.Foundation.Metadata.ContractVersion(typeof(Windows.Foundation.UniversalApiContract), 65536)]
[Windows.Foundation.Metadata.MarshalingBehavior(Windows.Foundation.Metadata.MarshalingType.Agile)]
[Windows.Foundation.Metadata.Threading(Windows.Foundation.Metadata.ThreadingModel.Both)]
[Windows.UI.Xaml.Markup.ContentProperty(Name="Inlines")]
public class Span : Inline

Public Class Span
Inherits Inline

<Span .../>
-or-
<Span ...>
  oneOrMoreInlines
</Span>
-or-
<Span ...>
  mixedContent
</Span>

继承

Object IInspectable DependencyObject TextElement Inline Span

派生

Windows.UI.Xaml.Documents.Bold

Windows.UI.Xaml.Documents.Hyperlink

Windows.UI.Xaml.Documents.Italic

Windows.UI.Xaml.Documents.Underline

属性

ContractVersionAttribute MarshalingBehaviorAttribute ThreadingAttribute ContentPropertyAttribute

Windows 要求

设备系列	Windows 10 (在 10.0.10240.0 中引入)
API contract	Windows.Foundation.UniversalApiContract (在 v1.0 中引入)

注解

可以使用 Span 作为 XAML 中的对象元素来包围文本。 这与在 HTML 中使用 标记的方式 span 类似。 对于此用法，你需要设置 TextElement 支持的属性，例如 FontSize 或 FontFamily，以便你可以将这些文本格式设置决策应用于封闭的文本跨度。 Run 具有向文本范围应用 TextElement 属性的类似功能，但 Run 不支持混合内容 (其 Run.Text XAML 内容属性只能包含文本，而不能包含混合内容和进一步内联) 。

如果在 XAML 中设置内容，则 Span 支持混合内容。 这意味着，可以将 Run、Bold 等内联标记与 XAML 文本内容混合使用， (纯文本) ，对标记与文本的显示顺序没有限制。 所有文本（无论是纯文本还是括在 内联 标记中）都按文本在混合内容中定义的顺序呈现。 例如，这是合法的 XAML：

<RichTextBlock>
  <Paragraph>
    <Span>This is <Bold>mixed content</Bold> with multiple text areas <Italic> and inlines</Italic>.</Span>
  </Paragraph>
</RichTextBlock>

当从 XAML 分析混合内容并在运行时检查文本对象模型时，来自纯文本的任何文本区域都会在 InlineCollection 集合类中启用运行时访问的相应阅读顺序位置生成 Run 对象。 该 Run 元素包含文本，但未设置属性。

注意

支持将 XAML 内容（无论是标记还是文本直接放在 Span 元素中）中，因为 Span 表示其 Inlines 属性是 XAML 内容属性。 有关 XAML 内容属性的详细信息，请参阅 XAML 语法指南的“XAML 内容属性”部分。

Span 元素通常用作 InlineCollection 中的元素，因为 Paragraph (的子元素成为 Paragraph.Inlines) 的一部分，或者当另一个 Span (的内容成为 Span.Inlines) 的一部分时。

Span 派生类

Span 是多个派生类的父类，这些类使用特定格式设置约定定义内联文本区域：

• 加粗
• 超链接
• 斜体
• 下划线超链接 启用导航到 NavigateUri 的单击行为。 可以将其他 Span 派生类视为文本的类特定修饰，否则不会添加交互。

构造函数

Span()

初始化 Span 类的新实例。

属性

AccessKey	获取或设置此元素的访问键。 (继承自 TextElement)
AccessKeyScopeOwner	获取或设置一个源元素，该元素提供此元素的访问键范围，即使它不在源元素的可视化树中也是如此。 (继承自 TextElement)
AllowFocusOnInteraction	获取或设置一个值，该值指示当用户与元素交互时是否自动获取焦点。 (继承自 TextElement)
CharacterSpacing	获取或设置字符之间的统一间距，单位为 1/1000 em。 (继承自 TextElement)
ContentEnd	获取一个 TextPointer ，它表示 元素中内容的末尾。 (继承自 TextElement)
ContentStart	获取一个 TextPointer ，它表示 元素中内容的开头。 (继承自 TextElement)
Dispatcher	获取与此对象关联的 CoreDispatcher 。 CoreDispatcher 表示可以访问 UI 线程上的 DependencyObject 的工具，即使代码是由非 UI 线程启动的。 (继承自 DependencyObject)
ElementEnd	获取一个 TextPointer ，它表示元素末尾之后的位置。 (继承自 TextElement)
ElementStart	获取一个 TextPointer ，它表示元素开始之前的位置。 (继承自 TextElement)
ExitDisplayModeOnAccessKeyInvoked	获取或设置一个值，该值指定在调用访问密钥时是否消除访问密钥显示。 (继承自 TextElement)
FontFamily	获取或设置元素内容的首选顶级字体系列。 (继承自 TextElement)
FontSize	获取或设置元素内容的字体大小。 (继承自 TextElement)
FontStretch	获取或设置系列中要选择的字体的字形宽度。 (继承自 TextElement)
FontStyle	获取或设置此元素中内容的字体样式。 (继承自 TextElement)
FontWeight	获取或设置要从此元素中内容的字体系列中选择的顶级字体粗细。 (继承自 TextElement)
Foreground	获取或设置要应用于此元素中内容的 Brush 。 (继承自 TextElement)
Inlines	获取一个 InlineCollection ，其中包含包含 Span 内容的顶级内联元素。
IsAccessKeyScope	获取或设置一个值，该值指示元素是否定义其自己的访问键范围。 (继承自 TextElement)
IsTextScaleFactorEnabled	获取或设置是否启用自动文本放大，以反映系统文本大小设置。 (继承自 TextElement)
KeyTipHorizontalOffset	获取或设置一个值，该值指示键提示相对于文本元素的左或右放置位置。 (继承自 TextElement)
KeyTipPlacementMode	获取或设置一个值，该值指示键提示相对于文本元素放置的位置。 (继承自 TextElement)
KeyTipVerticalOffset	获取或设置一个值，该值指示键提示相对于文本元素的向上或向下放置距离。 (继承自 TextElement)
Language	获取或设置应用于 TextElement 的本地化/全球化语言信息。 (继承自 TextElement)
Name	获取或设置 对象的唯一标识。 只能从 XAML 的初始分析中设置名称。 (继承自 TextElement)
TextDecorations	获取或设置一个值，该值指示应用于文本的修饰。 (继承自 TextElement)
XamlRoot	获取或设置在其中查看此元素的 XamlRoot。 (继承自 TextElement)

方法

ClearValue(DependencyProperty)	清除依赖属性的本地值。 (继承自 DependencyObject)
FindName(String)	通过引用对象的 x：Name 或 Name 属性值，在对象模型/运行时对象图中检索对象。 (继承自 TextElement)
GetAnimationBaseValue(DependencyProperty)	返回为依赖属性建立的任何基值，该基值适用于动画未处于活动状态的情况。 (继承自 DependencyObject)
GetValue(DependencyProperty)	从 DependencyObject 返回依赖属性的当前有效值。 (继承自 DependencyObject)
OnDisconnectVisualChildren()	重写此方法以实现从特定于类的内容或子属性中删除项时布局和逻辑的行为方式。 (继承自 TextElement)
ReadLocalValue(DependencyProperty)	如果设置了本地值，则返回依赖属性的本地值。 (继承自 DependencyObject)
RegisterPropertyChangedCallback(DependencyProperty, DependencyPropertyChangedCallback)	注册通知函数，用于侦听此 DependencyObject 实例上对特定 DependencyProperty 的更改。 (继承自 DependencyObject)
SetValue(DependencyProperty, Object)	设置 DependencyObject 上依赖属性的本地值。 (继承自 DependencyObject)
UnregisterPropertyChangedCallback(DependencyProperty, Int64)	取消以前通过调用 RegisterPropertyChangedCallback 注册的更改通知。 (继承自 DependencyObject)

事件

AccessKeyDisplayDismissed	当访问键序列完成时发生，以通知控件应隐藏访问键视觉对象。 (继承自 TextElement)
AccessKeyDisplayRequested	当访问键序列启动以通知控件它们应显示访问键视觉对象时发生。 (继承自 TextElement)
AccessKeyInvoked	当用户完成访问键序列以通知元素应调用访问键操作时发生。 (继承自 TextElement)

另请参阅

• Inline
• Paragraph