Block 类
定义
重要
一些信息与预发行产品相关，相应产品在发行之前可能会进行重大修改。 对于此处提供的信息，Microsoft 不作任何明示或暗示的担保。
一个抽象类，它为所有块级内容元素提供基。
public ref class Block : TextElement/// [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 Block : TextElement[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 Block : TextElementPublic Class Block
Inherits TextElement- 继承
- 派生
- 属性
注解
块定义文本格式设置属性，这些属性应应用于所有类型的块内容。 这些属性包括： LineHeight、 LineStackingStrategy、 Margin 和 TextAlignment。 块还继承 TextElement 的文本格式属性和其他 API。
在Windows 运行时 XAML 词汇中，唯一的块类型是 Paragraph。 使用 Paragraph 定义要在 RichTextBlock 控件中显示的文本块。 每个 RichTextBlock 应至少包含一个 段落。
BlockCollection 是 RichTextBlock.Blocks 属性使用的强类型集合类。 通过在 RichTextBlock 中指定 XAML 对象元素，可以为 RichTextBlock 分配块文本内容。 这通常使用隐式集合和 XAML 属性语法来完成，以便 Paragraph 元素在 XAML 标记中显示为 RichTextBlock 的直接子级。 例如：
<RichTextBlock>
<Paragraph>First paragraph.</Paragraph>
<Paragraph>Second paragraph.</Paragraph>
<Paragraph>Third paragraph. <Bold>With an inline.</Bold></Paragraph>
</RichTextBlock>
阻止 派生类
Block 是 Paragraph 的父类。
迁移说明
Windows 运行时 XAML 词汇不支持 Section 类。 如果要从 Windows Presentation Foundation (WPF) 或 Microsoft Silverlight 迁移 XAML，请改用 Paragraph 块元素。
构造函数
| Block() |
为 块 派生类提供基类初始化行为。 |
属性
| 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) |
| HorizontalTextAlignment |
获取或设置一个值，该值指示文本在块中的对齐方式。 |
| HorizontalTextAlignmentProperty |
标识 HorizontalTextAlignment 依赖属性。 |
| IsAccessKeyScope |
获取或设置一个值，该值指示元素是否定义其自己的访问键范围。 (继承自 TextElement) |
| IsTextScaleFactorEnabled |
获取或设置是否启用自动文本放大，以反映系统文本大小设置。 (继承自 TextElement) |
| KeyTipHorizontalOffset |
获取或设置一个值，该值指示键提示相对于文本元素的左或右放置位置。 (继承自 TextElement) |
| KeyTipPlacementMode |
获取或设置一个值，该值指示键提示相对于文本元素放置的位置。 (继承自 TextElement) |
| KeyTipVerticalOffset |
获取或设置一个值，该值指示键提示相对于文本元素的向上或向下放置距离。 (继承自 TextElement) |
| Language |
获取或设置应用于 TextElement 的本地化/全球化语言信息。 (继承自 TextElement) |
| LineHeight |
获取或设置各行内容的高度。 |
| LineHeightProperty |
标识 LineHeight 依赖属性。 |
| LineStackingStrategy |
获取或设置一个值，该值指示如何为 Block 中的每行文本确定行框。 |
| LineStackingStrategyProperty |
标识 LineStackingStrategy 依赖属性。 |
| Margin |
获取或设置 Block 元素周围的空间量。 |
| MarginProperty |
标识 Margin 依赖属性。 |
| Name |
获取或设置 对象的唯一标识。 只能从 XAML 的初始分析中设置名称。 (继承自 TextElement) |
| TextAlignment |
获取或设置文本内容的水平对齐方式。 |
| TextAlignmentProperty |
标识 TextAlignment 依赖属性。 |
| 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) |