Typography 类
定义
重要
一些信息与预发行产品相关，相应产品在发行之前可能会进行重大修改。 对于此处提供的信息，Microsoft 不作任何明示或暗示的担保。
提供对一组 Microsoft OpenType 版式属性的访问。 这些属性作为 XAML 附加属性实现，以便可以从文本对象模型属性以及特定文本控件中设置它们。
public ref class Typography sealed/// [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 Typography final[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 TypographyPublic NotInheritable Class Typography- 继承
- 属性
示例
此处，在 TextBlock 上设置版式值，以使用样式集 4 以小写格式呈现文本。
<TextBlock Text="Hello, world!"
Typography.Capitals="SmallCaps"
Typography.StylisticSet4="True"/>
TextBlock textBlock1 = new TextBlock();
textBlock1.Text = "Hello, world!";
Windows.UI.Xaml.Documents.Typography.SetCapitals(textBlock1, FontCapitals.SmallCaps);
Windows.UI.Xaml.Documents.Typography.SetStylisticSet4(textBlock1, true);
在此示例中，在 RichTextBlock 中运行时设置了 Typography.Fraction 附加属性。
<RichTextBlock>
<Paragraph>12 x <Run Typography.Fraction="Slashed">1/3</Run> = 4.</Paragraph>
</RichTextBlock>
注解
通常，将版式附加属性与 TextBlock 或 RichTextBlock 控件的文本一起使用。
注意
不能将这些属性用于 TextBox 或 RichEditBox 控件。
Typography 对象公开 Microsoft OpenType 字体支持的功能集。 通过在标记或代码中设置版式的属性，可以创作利用 Microsoft OpenType 功能的文档，并根据需要在每个元素级别启用这些功能。
某些字体包含对应于字符集部分的风格变体字形。 风格集中的字形可以设计为在视觉上协调、以特定方式交互或以其他方式协同工作。 其中一些变体由特定约定标识，例如字体可能具有任意连字。 在此示例中，可以通过将 Typography.DiscretionaryLigatures 设置为 true 来启用版式行为。 其他样式变体不由任何 Microsoft OpenType 集或约定标识，而是特定于该特定字体的版式设计。 可以通过将任何 StylisticSet# 附加属性设置为 true 来访问这些变体。
注意
只要有可能， TextBlock 会使用高效的 快速路径呈现文本。 只有各种版式附加属性的默认值是快速路径。 非默认值要求 TextBlock 回退到用于文本呈现的 CPU 密集型代码路径。 有关详细信息，请参阅 TextBlock 控件指南。
XAML 附加属性
版式是多个 XAML 附加属性的主机服务类。
为了支持 XAML 处理器访问附加属性，以及向代码公开等效 的 get 和 set 操作，每个 XAML 附加属性都有一对 Get 和 Set 访问器方法。 在代码中获取或设置值的另一种方法是使用依赖属性系统，调用 GetValue 或 SetValue ，并将标识符字段作为依赖属性标识符传递。
| 附加属性 | 说明 |
|---|---|
| AnnotationAlternates | 获取或设置一个扩展实例，该实例定义用于分阶段呈现数据模板的帮助程序方法。
|
| 大写字母 | 获取或设置一个 FontCapitals 值，该值指示所选字体的大写形式。
|
| CapitalSpacing | 获取或设置一个值，该值确定是否全局调整所有全大写文本的内部标志符号间距以提高可读性。
|
| CaseSensitiveForms | 获取或设置一个值，该值确定是否调整标志符号的垂直位置以更好地与大写标志符号对齐。
|
| ContextualAlternates | 获取或设置一个值，该值确定是否可以根据所呈现文本的上下文使用自定义标志符号格式。
|
| ContextualLigatures | 获取或设置一个值，该值确定是否启用上下文连字。
如果 Typography.ContextualLigatures 的值为 true ，并且所选字体不支持上下文连字，则会显示字母的默认格式。 |
| ContextualSwashes | 获取或设置一个值，该值指定上下文花体格式的索引。
|
| DiscretionaryLigatures | 获取或设置一个值，该值确定是否启用自由连字。
|
| EastAsianExpertForms | 获取或设置一个值，该值确定是否使用相应的首选版式格式替换标准日语字体格式。
|
| EastAsianLanguage | 获取或设置一个 FontEastAsianLanguage 值，该值指示用于特定书写系统或语言的字形。 |
| EastAsianWidths | 获取或设置一个 FontEastAsianWidths 值，该值指示东亚字体中拉丁字符的比例宽度。
|
| Fraction | 获取或设置一个 FontFraction 值，该值指示分数样式。
|
| HistoricalForms | 获取或设置一个值，该值确定是否启用历史记录格式。
|
| HistoricalLigatures | 获取或设置一个值，该值指示是否启用历史记录连字。
|
| 字距调整 | 获取或设置一个值，该值指示是否启用字距调整。 字距调整是一种版式功能，用于调整字符之间的间距以增强字形。
|
| MathematicalGreek | 获取或设置一个值，该值指示是否使用在数学符号中常用的相应字体格式替换希腊语标志符号的标准版式字体格式。
|
| NumeralAlignment | 获取或设置一个 FontNumeralAlignment 值，该值指示数字宽度的对齐方式。 OpenType 字体支持比例数字和表格式数字功能，可在使用数字时控制宽度对齐。 比例数字将每个数字视为具有不同宽度 (1 小于 5) 。 表格数字被视为等宽数字，以便它们垂直对齐，从而提高财务类型信息的可读性。 |
| NumeralStyle | 获取或设置一个 FontNumeralStyle 值，该值确定用于呈现数字备用字体形式的字形集。
|
| SlashedZero | 获取或设置一个值，该值指示是否使用斜杠零替换标称零字体格式。
|
| StandardLigatures | 获取或设置一个值，该值指示是否启用标准连字。
|
| StandardSwashes | 获取或设置一个值，该值指定标准花体格式的索引。
|
| StylisticAlternates | 获取或设置一个值，该值指定样式备用项格式的索引。
|
| StylisticSet1 | 获取或设置一个值，该值指示是否启用字体格式的样式集。
|
| StylisticSet2 | 获取或设置一个值，该值指示是否启用字体格式的样式集。
|
| StylisticSet3 | 获取或设置一个值，该值指示是否启用字体格式的样式集。
|
| StylisticSet4 | 获取或设置一个值，该值指示是否启用字体格式的样式集。
|
| StylisticSet5 | 获取或设置一个值，该值指示是否启用字体格式的样式集。
|
| StylisticSet6 | 获取或设置一个值，该值指示是否启用字体格式的样式集。
|
| StylisticSet7 | 获取或设置一个值，该值指示是否启用字体格式的样式集。
|
| StylisticSet8 | 获取或设置一个值，该值指示是否启用字体格式的样式集。
|
| StylisticSet9 | 获取或设置一个值，该值指示是否启用字体格式的样式集。
|
| StylisticSet10 | 获取或设置一个值，该值指示是否启用字体格式的样式集。
|
| StylisticSet11 | 获取或设置一个值，该值指示是否启用字体格式的样式集。
|
| StylisticSet12 | 获取或设置一个值，该值指示是否启用字体格式的样式集。
|
| StylisticSet13 | 获取或设置一个值，该值指示是否启用字体格式的样式集。
|
| StylisticSet14 | 获取或设置一个值，该值指示是否启用字体格式的样式集。
|
| StylisticSet15 | 获取或设置一个值，该值指示是否启用字体格式的样式集。
|
| StylisticSet16 | 获取或设置一个值，该值指示是否启用字体格式的样式集。
|
| StylisticSet17 | 获取或设置一个值，该值指示是否启用字体格式的样式集。
|
| StylisticSet18 | 获取或设置一个值，该值指示是否启用字体格式的样式集。
|
| StylisticSet19 | 获取或设置一个值，该值指示是否启用字体格式的样式集。
|
| StylisticSet20 | 获取或设置一个值，该值指示是否启用字体格式的样式集。
|
| 变量 | 获取或设置一个 FontVariants 值，该值指示要使用的标准版式窗体的变体。
|
属性
附加属性
| AnnotationAlternates |
获取或设置一个扩展实例，该实例定义用于分阶段呈现数据模板的帮助程序方法。 |
| Capitals |
获取或设置一个 FontCapitals 值，该值指示所选字体的大写形式。 |
| CapitalSpacing |
获取或设置一个值，该值确定是否全局调整所有全大写文本的内部标志符号间距以提高可读性。 |
| CaseSensitiveForms |
获取或设置一个值，该值确定是否调整标志符号的垂直位置以更好地与大写标志符号对齐。 |
| ContextualAlternates |
获取或设置一个值，该值确定是否可以根据所呈现文本的上下文使用自定义标志符号格式。 |
| ContextualLigatures |
获取或设置一个值，该值确定是否启用上下文连字。 |
| ContextualSwashes |
获取或设置一个值，该值指定上下文花体格式的索引。 |
| DiscretionaryLigatures |
获取或设置一个值，该值确定是否启用自由连字。 |
| EastAsianExpertForms |
获取或设置一个值，该值确定是否使用相应的首选版式格式替换标准日语字体格式。 |
| EastAsianLanguage |
获取或设置一个 FontEastAsianLanguage 值，该值指示用于特定书写系统或语言的字形。 |
| EastAsianWidths |
获取或设置一个 FontEastAsianWidths 值，该值指示东亚字体中拉丁字符的比例宽度。 |
| Fraction |
获取或设置一个 FontFraction 值，该值指示分数样式。 |
| HistoricalForms |
获取或设置一个值，该值确定是否启用历史记录格式。 |
| HistoricalLigatures |
获取或设置一个值，该值指示是否启用历史记录连字。 |
| Kerning |
获取或设置一个值，该值指示是否启用字距调整。 |
| MathematicalGreek |
获取或设置一个值，该值指示是否使用在数学符号中常用的相应字体格式替换希腊语标志符号的标准版式字体格式。 |
| NumeralAlignment |
获取或设置一个 FontNumeralAlignment 值，该值指示数字宽度的对齐方式。 |
| NumeralStyle |
获取或设置一个 FontNumeralStyle 值，该值确定用于呈现数字备用字体形式的字形集。 |
| SlashedZero |
获取或设置一个值，该值指示是否使用斜杠零替换标称零字体格式。 |
| StandardLigatures |
获取或设置一个值，该值指示是否启用标准连字。 |
| StandardSwashes |
获取或设置一个值，该值指定标准花体格式的索引。 |
| StylisticAlternates |
获取或设置一个值，该值指定样式备用项格式的索引。 |
| StylisticSet1 |
获取或设置一个值，该值指示是否启用字体格式的样式集。 |
| StylisticSet10 |
获取或设置一个值，该值指示是否启用字体格式的样式集。 |
| StylisticSet11 |
获取或设置一个值，该值指示是否启用字体格式的样式集。 |
| StylisticSet12 |
获取或设置一个值，该值指示是否启用字体格式的样式集。 |
| StylisticSet13 |
获取或设置一个值，该值指示是否启用字体格式的样式集。 |
| StylisticSet14 |
获取或设置一个值，该值指示是否启用字体格式的样式集。 |
| StylisticSet15 |
获取或设置一个值，该值指示是否启用字体格式的样式集。 |
| StylisticSet16 |
获取或设置一个值，该值指示是否启用字体格式的样式集。 |
| StylisticSet17 |
获取或设置一个值，该值指示是否启用字体格式的样式集。 |
| StylisticSet18 |
获取或设置一个值，该值指示是否启用字体格式的样式集。 |
| StylisticSet19 |
获取或设置一个值，该值指示是否启用字体格式的样式集。 |
| StylisticSet2 |
获取或设置一个值，该值指示是否启用字体格式的样式集。 |
| StylisticSet20 |
获取或设置一个值，该值指示是否启用字体格式的样式集。 |
| StylisticSet3 |
获取或设置一个值，该值指示是否启用字体格式的样式集。 |
| StylisticSet4 |
获取或设置一个值，该值指示是否启用字体格式的样式集。 |
| StylisticSet5 |
获取或设置一个值，该值指示是否启用字体格式的样式集。 |
| StylisticSet6 |
获取或设置一个值，该值指示是否启用字体格式的样式集。 |
| StylisticSet7 |
获取或设置一个值，该值指示是否启用字体格式的样式集。 |
| StylisticSet8 |
获取或设置一个值，该值指示是否启用字体格式的样式集。 |
| StylisticSet9 |
获取或设置一个值，该值指示是否启用字体格式的样式集。 |
| Variants |
获取或设置一个 FontVariants 值，该值指示要使用的标准版式窗体的变体。 |
方法
适用于
另请参阅
反馈
即将发布：在整个 2024 年，我们将逐步淘汰作为内容反馈机制的“GitHub 问题”，并将其取代为新的反馈系统。 有关详细信息，请参阅：https://aka.ms/ContentUserFeedback。
提交和查看相关反馈