Span 类
定义
重要
一些信息与预发行产品相关,相应产品在发行之前可能会进行重大修改。 对于此处提供的信息,Microsoft 不作任何明示或暗示的担保。
/// [Microsoft.UI.Xaml.Markup.ContentProperty(Name="Inlines")]
/// [Windows.Foundation.Metadata.ContractVersion(Microsoft.UI.Xaml.WinUIContract, 65536)]
/// [Windows.Foundation.Metadata.MarshalingBehavior(Windows.Foundation.Metadata.MarshalingType.Agile)]
/// [Windows.Foundation.Metadata.Threading(Windows.Foundation.Metadata.ThreadingModel.Both)]
class Span : Inline
[Microsoft.UI.Xaml.Markup.ContentProperty(Name="Inlines")]
[Windows.Foundation.Metadata.ContractVersion(typeof(Microsoft.UI.Xaml.WinUIContract), 65536)]
[Windows.Foundation.Metadata.MarshalingBehavior(Windows.Foundation.Metadata.MarshalingType.Agile)]
[Windows.Foundation.Metadata.Threading(Windows.Foundation.Metadata.ThreadingModel.Both)]
public class Span : Inline
Public Class Span
Inherits Inline
<Span .../>
-or-
<Span ...>
oneOrMoreInlines
</Span>
-or-
<Span ...>
mixedContent
</Span>
- 继承
- 派生
- 属性
注解
可以使用 Span 作为 XAML 中的对象元素来封闭文本。 这样就可以使用与如何在 span HTML 中使用标记类似的用法。 对于此用法,你将设置 TextElement 支持的属性(如 FontSize 或 FontFamily),以便可以将这些文本格式设置决策应用于封闭的文本范围。
Run 具有将 TextElement 属性应用于一系列文本的类似功能,但 Run 不支持混合内容(其 Run.Text XAML 内容属性只能包含文本,不能混合内容和进一步内联)。
如果以 XAML 设置内容,Span 支持混合内容。 这意味着,可以将内联标记(如“运行”、“粗体”等与 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 元素包含文本,但未设置任何属性。
注释
支持在 Span 元素中直接放置 XAML 内容,因为 Span 表示其 Inlines 属性是 XAML 内容属性。 有关 XAML 内容属性的详细信息,请参阅 XAML 语法指南的“XAML 内容属性”部分。
Span 元素通常用作 InlineCollection 中的元素,要么用作 Paragraph 的子元素(成为 Paragraph.Inlines 的一部分),要么用作另一个 Span 的内容(成为 Span.Inlines 的一部分)。
跨 度派生类
Span 是多个派生类的父类,用于定义具有特定格式约定的内联文本区域:
超链接 启用导航到 NavigateUri 的单击行为。 可以将其他 Span 派生类视为文本的特定于类的修饰,否则不要添加交互。
构造函数
| 名称 | 说明 |
|---|---|
| Span() |
初始化 Span 类的新实例。 |
属性
| 名称 | 说明 |
|---|---|
| AccessKey |
获取或设置此元素的访问键。 (继承自 TextElement) |
| AccessKeyScopeOwner |
获取或设置一个源元素,该元素提供此元素的访问键范围,即使它不在源元素的可视化树中也是如此。 (继承自 TextElement) |
| AllowFocusOnInteraction |
获取或设置一个值,该值指示当用户与其交互时元素是否自动获得焦点。 (继承自 TextElement) |
| CharacterSpacing |
获取或设置字符之间的统一间距,单位为 1/1000 em。 (继承自 TextElement) |
| ContentEnd |
获取一个 TextPointer ,表示元素中内容的末尾。 (继承自 TextElement) |
| ContentStart |
获取一个 TextPointer ,表示元素中内容的开头。 (继承自 TextElement) |
| Dispatcher |
始终在 Windows 应用 SDK 应用中返回 |
| DispatcherQueue |
获取 |
| ElementEnd |
获取一个 TextPointer ,它表示元素末尾之后的位置。 (继承自 TextElement) |
| ElementStart |
获取一个 TextPointer ,表示元素开头前的位置。 (继承自 TextElement) |
| ExitDisplayModeOnAccessKeyInvoked |
获取或设置一个值,该值指定在调用访问密钥时是否消除访问密钥显示。 (继承自 TextElement) |
| FontFamily |
获取或设置元素内容的首选顶级字体系列。 (继承自 TextElement) |
| FontSize |
获取或设置元素内容的字号。 (继承自 TextElement) |
| FontStretch |
获取或设置要选择的系列中字体的字形宽度。 (继承自 TextElement) |
| FontStyle |
获取或设置此元素中内容的字体样式。 (继承自 TextElement) |
| FontWeight |
获取或设置要从此元素中内容的字体系列中选择的顶级字体粗细。 (继承自 TextElement) |
| Foreground |
获取或设置要应用于此元素中内容的 Brush 。 (继承自 TextElement) |
| Inlines |
获取包含 Span 内容的顶级内联元素的 InlineCollection。 |
| 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) |