Run 类
定义
重要
一些信息与预发行产品相关，相应产品在发行之前可能会进行重大修改。 对于此处提供的信息，Microsoft 不作任何明示或暗示的担保。
表示带格式或无格式文本的离散部分。
public ref class Run sealed : Inline/// [Microsoft.UI.Xaml.Markup.ContentProperty(Name="Text")]
/// [Windows.Foundation.Metadata.Activatable(65536, "Microsoft.UI.Xaml.WinUIContract")]
/// [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 Run final : Inline[Microsoft.UI.Xaml.Markup.ContentProperty(Name="Text")]
[Windows.Foundation.Metadata.Activatable(65536, "Microsoft.UI.Xaml.WinUIContract")]
[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 sealed class Run : InlinePublic NotInheritable Class Run
Inherits Inline<Run .../>
-or-
<Run ...>text</Run>
- 继承
- 属性
示例
此处所示的每个示例都呈现相同的结果。 但是，直接在 TextBlock 上设置 Text 属性具有最佳性能。
<!-- Set the TextBlock.Text property directy for best performance. -->
<TextBlock Text="This is some text."/>
<TextBlock><Run>This is some text.</Run></TextBlock>
<TextBlock><Run Text="This is some text."></Run></TextBlock>
// Set the TextBlock.Text property directy for best performance.
TextBlock textblock = new TextBlock();
textblock.Text = "This is some text.";
TextBlock textblock = new TextBlock();
Run run = new Run();
run.Text = "This is some text.";
textblock.Inlines.Add(run);
注解
Run 表示格式化或无格式文本的离散部分，可在 TextBlock 或 RichTextBlock 中使用。 可以将多个 Run 元素放置在 Span 内。
使用 TextBlock 时，请直接设置 TextBlock.Text 属性以获取最佳性能。 通常，仅当想要设置 TextBlock 中文本的离散部分的格式时，才使用 Run 元素。
有关更多示例，请参阅
构造函数
| Run() |
初始化 Run 类的新实例。 |
属性
| 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) |
| FlowDirection |
获取或设置文本和其他用户界面元素在 Run 元素中流动的方向，该元素控制其布局。 |
| FlowDirectionProperty |
标识 FlowDirection 依赖属性。 |
| FontFamily |
获取或设置元素内容的首选顶级字体系列。 (继承自 TextElement) |
| FontSize |
获取或设置元素内容的字体大小。 (继承自 TextElement) |
| FontStretch |
获取或设置系列中要选择的字体的字形宽度。 (继承自 TextElement) |
| FontStyle |
获取或设置此元素中内容的字体样式。 (继承自 TextElement) |
| FontWeight |
获取或设置要从此元素中内容的字体系列中选择的顶级字体粗细。 (继承自 TextElement) |
| Foreground |
获取或设置要应用于此元素中内容的 Brush 。 (继承自 TextElement) |
| IsAccessKeyScope |
获取或设置一个值，该值指示元素是否定义其自己的访问键范围。 (继承自 TextElement) |
| IsTextScaleFactorEnabled |
获取或设置是否启用自动文本放大，以反映系统文本大小设置。 (继承自 TextElement) |
| KeyTipHorizontalOffset |
获取或设置一个值，该值指示键提示相对于文本元素的左或右放置位置。 (继承自 TextElement) |
| KeyTipPlacementMode |
获取或设置一个值，该值指示键提示相对于文本元素放置的位置。 (继承自 TextElement) |
| KeyTipVerticalOffset |
获取或设置一个值，该值指示键提示相对于文本元素的向上或向下放置距离。 (继承自 TextElement) |
| Language |
获取或设置应用于 TextElement 的本地化/全球化语言信息。 (继承自 TextElement) |
| Name |
获取或设置 对象的唯一标识。 只能从 XAML 的初始分析中设置名称。 (继承自 TextElement) |
| Text |
获取或设置 运行的文本内容。 |
| 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) |