Run 类

定义

表示带格式或无格式文本的离散部分。

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 : Inline
Public NotInheritable Class Run
Inherits Inline
<Run .../>
-or-
<Run ...>text</Run>
继承
Object Platform::Object IInspectable DependencyObject TextElement Inline 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 表示格式化或无格式文本的离散部分,可在 TextBlockRichTextBlock 中使用。 可以将多个 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应用中返回 null 。 请改用 DispatcherQueue

(继承自 DependencyObject)
DispatcherQueue

DispatcherQueue获取与此对象关联的 。 表示 DispatcherQueue 一个可以在 UI 线程上访问 DependencyObject 的设施,即使代码是由非 UI 线程启动的。

(继承自 DependencyObject)
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:NameName 属性值,在对象模型/运行时对象图中检索对象。

(继承自 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)

适用于

另请参阅