GlyphRun 对象与 Glyphs 元素的简介

项目
01/30/2025

本主题介绍 GlyphRun 对象和 Glyphs 元素。

GlyphRun 简介

Windows Presentation Foundation (WPF) 为希望在格式化后截取和保留文本的客户提供高级文本支持，包括可直接访问 Glyphs 的字形级标记。这些功能为以下每种方案中的不同文本呈现要求提供关键支持。

固定格式文档的屏幕显示。
打印方案。
- 可扩展应用程序标记语言（XAML）作为设备打印机语言。
- Microsoft XPS 文档编写器。
- 以前的打印机驱动程序，从 Win32 应用程序输出到固定格式。
- 打印后台处理格式。
固定格式的文档演示，包括以前版本的 Windows 客户端和其他计算设备。

说明

Glyphs 和 GlyphRun 专为固定格式的文档演示和打印方案而设计。 WPF 为常规布局和用户界面（UI）方案（如 Label 和 TextBlock）提供了多个元素。有关布局和 UI 方案的详细信息，请参阅 WPF中的版式。

GlyphRun 对象

GlyphRun 对象表示一系列字形，这些字形来自单个字体、单一尺寸，并且应用单一的渲染样式。

GlyphRun 包括字形 Indices 和单个字形位置等字体详细信息。它还包括运行生成自的原始 Unicode 代码点、字符到字形缓冲偏移映射信息，以及每字符和每字形标志。

GlyphRun 具有相应的高级别 FrameworkElement、Glyphs。 Glyphs 可以在元素树和 XAML 标记中表示 GlyphRun 输出。

Glyphs 元素

Glyphs 元素表示 XAML 中 GlyphRun 的输出。以下标记语法用于描述 Glyphs 元素。

<!-- The example shows how to use a Glyphs object. -->
<Page
  xmlns="http://schemas.microsoft.com/winfx/2006/xaml/presentation"
  xmlns:x="http://schemas.microsoft.com/winfx/2006/xaml"
  >

   <StackPanel Background="PowderBlue">

      <Glyphs
         FontUri             = "C:\WINDOWS\Fonts\TIMES.TTF"
         FontRenderingEmSize = "100"
         StyleSimulations    = "BoldSimulation"
         UnicodeString       = "Hello World!"
         Fill                = "Black"
         OriginX             = "100"
         OriginY             = "200"
      />

   </StackPanel>
</Page>

以下属性定义对应于示例标记中的前四个属性。

财产	描述
FontUri	指定资源标识符：文件名、Web 统一资源标识符（URI）或应用程序 .exe 或容器中的资源引用。
FontRenderingEmSize	指定绘图图面单位中的字号（默认值为 .96 英寸）。
StyleSimulations	指定粗体和斜体样式的标志。
BidiLevel	指定双向布局级别。偶数值和零值表示从左到右布局;奇数值表示从右到左布局。

Indices 属性

Indices 属性是字形规范的字符串。在一系列字形形成单个群集的情况下，群集中第一个字形的规范之前会跟有一个规范，说明组合了多少个字形和多少个代码点来形成群集。 Indices 属性将以下属性合并成一个字符串。

字形索引
字形步进宽度
组合字形附加矢量
从代码点到字形的群集映射
字形标志

每个字形规范具有以下形式。

[GlyphIndex][,[Advance][,[uOffset][,[vOffset][,[Flags]]]]]

字形度量值

每个字形定义一些指标，这些指标指定它与其他 Glyphs的对齐方式。图表展示了两个不同字形字符的各种排版特性。

标志符号度量示意图

Glyphs 标记

下面的代码示例演示如何在 XAML 中使用 Glyphs 元素的各种属性。

<!-- The example shows how to use different property settings of Glyphs objects. -->
<Canvas
  xmlns="http://schemas.microsoft.com/winfx/2006/xaml/presentation"
  xmlns:x="http://schemas.microsoft.com/winfx/2006/xaml"
  Background="PowderBlue"
  >

<Glyphs 
   FontUri             = "C:\WINDOWS\Fonts\ARIAL.TTF"
   FontRenderingEmSize = "36"
   StyleSimulations    = "ItalicSimulation"
   UnicodeString       = "Hello World!"
   Fill                = "SteelBlue"
   OriginX             = "50"
   OriginY             = "75"
/>

<!-- "Hello World!" with default kerning -->
<Glyphs 
   FontUri             = "C:\WINDOWS\Fonts\ARIAL.TTF"
   FontRenderingEmSize = "36"
   UnicodeString       = "Hello World!"
   Fill                = "Maroon"
   OriginX             = "50"
   OriginY             = "150"
/>

<!-- "Hello World!" with explicit character widths for proportional font -->
<Glyphs 
   FontUri             = "C:\WINDOWS\Fonts\ARIAL.TTF"
   FontRenderingEmSize = "36"
   UnicodeString       = "Hello World!"
   Indices             = ",80;,80;,80;,80;,80;,80;,80;,80;,80;,80;,80"
   Fill                = "Maroon"
   OriginX             = "50"
   OriginY             = "225"
/>

<!-- "Hello World!" with fixed-width font -->
<Glyphs 
     FontUri             = "C:\WINDOWS\Fonts\COUR.TTF"
     FontRenderingEmSize = "36"
     StyleSimulations    = "BoldSimulation"
     UnicodeString       = "Hello World!"
     Fill                = "Maroon"
     OriginX             = "50"
     OriginY             = "300"
/>

<!-- "Open file" without "fi" ligature -->
<Glyphs
   FontUri             = "C:\WINDOWS\Fonts\TIMES.TTF"
   FontRenderingEmSize = "36"
   StyleSimulations    = "BoldSimulation"
   UnicodeString       = "Open file"
   Fill                = "SlateGray"
   OriginX             = "400"
   OriginY             = "75"
/>

<!-- "Open file" with "fi" ligature -->
<Glyphs
   FontUri             = "C:\WINDOWS\Fonts\TIMES.TTF"
   FontRenderingEmSize = "36"
   StyleSimulations    = "BoldSimulation"
   UnicodeString       = "Open file"
   Indices             = ";;;;;(2:1)191"
   Fill                = "SlateGray"
   OriginX             = "400"
   OriginY             = "150"
/>

</Canvas>

通过