GlyphRunDrawing 类

参考

定义

命名空间:: System.Windows.Media

程序集:: PresentationCore.dll

重要

一些信息与预发行产品相关，相应产品在发行之前可能会进行重大修改。对于此处提供的信息，Microsoft 不作任何明示或暗示的担保。

表示呈现 GlyphRun的 Drawing 对象。

public ref class GlyphRunDrawing sealed : System::Windows::Media::Drawing

public sealed class GlyphRunDrawing : System.Windows.Media.Drawing

type GlyphRunDrawing = class
    inherit Drawing

Public NotInheritable Class GlyphRunDrawing
Inherits Drawing

继承: Object

DispatcherObject

DependencyObject

Freezable

Animatable

Drawing
GlyphRunDrawing

示例

以下示例使用 GlyphRunDrawing 绘制文本“Hello World”。

GlyphRun theGlyphRun = new GlyphRun(
    new GlyphTypeface(new Uri(@"C:\WINDOWS\Fonts\TIMES.TTF")),
    0,
    false,
    13.333333333333334,
    new ushort[]{43, 72, 79, 79, 82, 3, 58, 82, 85, 79, 71},
    new Point(0, 12.29),
    new double[]{
        9.62666666666667, 7.41333333333333, 2.96, 
        2.96, 7.41333333333333, 3.70666666666667, 
        12.5866666666667, 7.41333333333333, 
        4.44, 2.96, 7.41333333333333},
    null,
    null,
    null,
    null,
    null,
    null

    );

GlyphRunDrawing gDrawing = new GlyphRunDrawing(Brushes.Black, theGlyphRun);

<GlyphRunDrawing ForegroundBrush="Black">
  <GlyphRunDrawing.GlyphRun>
    <GlyphRun 
      CaretStops="{x:Null}" 
      ClusterMap="{x:Null}" 
      IsSideways="False" 
      GlyphOffsets="{x:Null}" 
      GlyphIndices="43 72 79 79 82 3 58 82 85 79 71" 
      BaselineOrigin="0,12.29"  
      FontRenderingEmSize="13.333333333333334" 
      DeviceFontName="{x:Null}" 
      AdvanceWidths="9.62666666666667 7.41333333333333 2.96 2.96 7.41333333333333 3.70666666666667 12.5866666666667 7.41333333333333 4.44 2.96 7.41333333333333" 
      BidiLevel="0">
      <GlyphRun.GlyphTypeface>
        <GlyphTypeface FontUri="C:\WINDOWS\Fonts\TIMES.TTF" />
      </GlyphRun.GlyphTypeface>
    </GlyphRun>
  </GlyphRunDrawing.GlyphRun>
</GlyphRunDrawing>

GlyphRun 是一个低级别对象，用于固定格式的文档演示和打印方案。将文本绘制到屏幕的更简单方法是使用 Label 或 TextBlock。有关的详细信息，请参阅 GlyphRun 对象和 Glyphs 元素概述简介。

注解

GlyphRun 对象表示一系列字形，该字形来自单个字体的单个字体，大小为单个，并且具有单个呈现样式。

GlyphRun 包含字形索引和单个字形位置等字体详细信息。此外，GlyphRun 包含从中生成的原始 Unicode 码位、字符到字形缓冲区偏移映射信息以及每个字符和每字形标志。

GlyphRun 中的每个字形定义指定它与其他 Glyphs的对齐方式的指标。下图定义了两个不同的字形字符的各种版式质量。

字形度量的分字图
两个不同的字形字符的各种版式质量

冻结功能： A GlyphRunDrawing 是一种 Freezable 对象，因此可以冻结以提高性能。有关冻结和克隆等 Freezable 功能的信息，请参阅可冻结对象概述。

警告：GlyphRunDrawing 对象不支持部分信任执行。应用程序必须具有完全信任权限才能使用 GlyphRunDrawing 对象。

构造函数

GlyphRunDrawing()	初始化 GlyphRunDrawing 类的新实例。
GlyphRunDrawing(Brush, GlyphRun)	通过指定前台画笔和 GlyphRun初始化 GlyphRunDrawing 类的新实例。

字段

ForegroundBrushProperty	标识 ForegroundBrush 依赖属性。
GlyphRunProperty	标识 GlyphRun 依赖属性。

属性

Bounds	获取绘图内容的轴对齐边界。 (继承自 Drawing)
CanFreeze	获取一个值，该值指示是否可以使对象不可修改。 (继承自 Freezable)
DependencyObjectType	获取包装此实例的 CLR 类型的 DependencyObjectType。 (继承自 DependencyObject)
Dispatcher	获取与此 DispatcherObject 关联的 Dispatcher。 (继承自 DispatcherObject)
ForegroundBrush	获取或设置 GlyphRunDrawing的前景画笔。
GlyphRun	获取或设置描述要绘制的文本的 GlyphRun。
HasAnimatedProperties	获取一个值，该值指示一个或多个 AnimationClock 对象是否与此对象的依赖属性相关联。 (继承自 Animatable)
IsFrozen	获取一个值，该值指示对象当前是否可修改。 (继承自 Freezable)
IsSealed	获取一个值，该值指示此实例当前是否密封（只读）。 (继承自 DependencyObject)

方法

ApplyAnimationClock(DependencyProperty, AnimationClock)	将 AnimationClock 应用于指定的 DependencyProperty。如果该属性已进行动画处理，则使用 SnapshotAndReplace 交接行为。 (继承自 Animatable)
ApplyAnimationClock(DependencyProperty, AnimationClock, HandoffBehavior)	将 AnimationClock 应用于指定的 DependencyProperty。如果该属性已进行动画处理，则使用指定的 HandoffBehavior。 (继承自 Animatable)
BeginAnimation(DependencyProperty, AnimationTimeline)	将动画应用于指定的 DependencyProperty。当呈现下一帧时，将启动动画。如果指定的属性已进行动画处理，则使用 SnapshotAndReplace 交接行为。 (继承自 Animatable)
BeginAnimation(DependencyProperty, AnimationTimeline, HandoffBehavior)	将动画应用于指定的 DependencyProperty。当呈现下一帧时，将启动动画。如果指定的属性已进行动画处理，则使用指定的 HandoffBehavior。 (继承自 Animatable)
CheckAccess()	确定调用线程是否有权访问此 DispatcherObject。 (继承自 DispatcherObject)
ClearValue(DependencyProperty)	清除属性的本地值。要清除的属性由 DependencyProperty 标识符指定。 (继承自 DependencyObject)
ClearValue(DependencyPropertyKey)	清除只读属性的本地值。要清除的属性由 DependencyPropertyKey指定。 (继承自 DependencyObject)
Clone()	创建此 GlyphRunDrawing的可修改克隆，从而生成此对象的值的深层副本。复制依赖项属性时，此方法复制资源引用和数据绑定（但它们可能不再解析），但不能解析动画或其当前值。
CloneCore(Freezable)	使用基（非动画化）属性值将指定 Freezable 的实例创建克隆（深层副本）。 (继承自 Freezable)
CloneCurrentValue()	创建此 GlyphRunDrawing 对象的可修改克隆，对此对象的当前值进行深层副本。不会复制资源引用、数据绑定和动画，而是复制其当前值。
CloneCurrentValueCore(Freezable)	使用当前属性值使实例成为指定 Freezable 的可修改克隆（深层副本）。 (继承自 Freezable)
CoerceValue(DependencyProperty)	强制指定依赖属性的值。这是通过在调用 DependencyObject上调用依赖属性的属性元数据中指定的任何 CoerceValueCallback 函数来实现的。 (继承自 DependencyObject)
CreateInstance()	初始化 Freezable 类的新实例。 (继承自 Freezable)
CreateInstanceCore()	在派生类中实现时，创建 Freezable 派生类的新实例。 (继承自 Freezable)
Equals(Object)	确定提供的 DependencyObject 是否等效于当前 DependencyObject。 (继承自 DependencyObject)
Freeze()	使当前对象不可修改，并将其 IsFrozen 属性设置为 `true`。 (继承自 Freezable)
FreezeCore(Boolean)	使此 Animatable 对象不可修改，或确定是否可以将其设为不可修改。 (继承自 Animatable)
GetAnimationBaseValue(DependencyProperty)	返回指定 DependencyProperty的非动画值。 (继承自 Animatable)
GetAsFrozen()	使用基本（非动画）属性值创建 Freezable的冻结副本。由于副本已冻结，因此引用复制任何冻结的子对象。 (继承自 Freezable)
GetAsFrozenCore(Freezable)	使用基（非动画化）属性值将实例作为指定 Freezable 的冻结克隆。 (继承自 Freezable)
GetCurrentValueAsFrozen()	使用当前属性值创建 Freezable 的冻结副本。由于副本已冻结，因此引用复制任何冻结的子对象。 (继承自 Freezable)
GetCurrentValueAsFrozenCore(Freezable)	使当前实例成为指定 Freezable的冻结克隆。如果对象具有动画依赖属性，则复制其当前动画值。 (继承自 Freezable)
GetHashCode()	获取此 DependencyObject的哈希代码。 (继承自 DependencyObject)
GetLocalValueEnumerator()	创建一个专用枚举器，用于确定哪些依赖项属性在此 DependencyObject上具有本地设置的值。 (继承自 DependencyObject)
GetType()	获取当前实例的 Type。 (继承自 Object)
GetValue(DependencyProperty)	返回此 DependencyObject实例上的依赖属性的当前有效值。 (继承自 DependencyObject)
InvalidateProperty(DependencyProperty)	重新评估指定依赖属性的有效值。 (继承自 DependencyObject)
MemberwiseClone()	创建当前 Object的浅表副本。 (继承自 Object)
OnChanged()	修改当前 Freezable 对象时调用。 (继承自 Freezable)
OnFreezablePropertyChanged(DependencyObject, DependencyObject)	确保为刚刚设置 DependencyObjectType 数据成员建立适当的上下文指针。 (继承自 Freezable)
OnFreezablePropertyChanged(DependencyObject, DependencyObject, DependencyProperty)	此成员支持 Windows Presentation Foundation （WPF）基础结构，不应直接从代码使用。 (继承自 Freezable)
OnPropertyChanged(DependencyPropertyChangedEventArgs)	重写 OnPropertyChanged(DependencyPropertyChangedEventArgs) 的 DependencyObject 实现，以调用任何 Changed 处理程序，以响应类型 Freezable更改的依赖属性。 (继承自 Freezable)
ReadLocalValue(DependencyProperty)	返回依赖属性的本地值（如果存在）。 (继承自 DependencyObject)
ReadPreamble()	确保从有效线程访问 Freezable。 Freezable 继承者必须在读取非依赖属性的数据成员的任何 API 的开头调用此方法。 (继承自 Freezable)
SetCurrentValue(DependencyProperty, Object)	设置依赖项属性的值，而不更改其值源。 (继承自 DependencyObject)
SetValue(DependencyProperty, Object)	设置依赖属性的本地值，由依赖属性标识符指定。 (继承自 DependencyObject)
SetValue(DependencyPropertyKey, Object)	设置由依赖属性的 DependencyPropertyKey 标识符指定的只读依赖属性的本地值。 (继承自 DependencyObject)
ShouldSerializeProperty(DependencyProperty)	返回一个值，该值指示序列化进程是否应序列化所提供的依赖属性的值。 (继承自 DependencyObject)
ToString()	返回一个表示当前对象的字符串。 (继承自 Object)
VerifyAccess()	强制调用线程有权访问此 DispatcherObject。 (继承自 DispatcherObject)
WritePostscript()	为 Freezable 引发 Changed 事件并调用其 OnChanged() 方法。派生自 Freezable 的类应在修改未存储为依赖属性的类成员的任何 API 末尾调用此方法。 (继承自 Freezable)
WritePreamble()	验证 Freezable 是否未冻结，以及是否正在从有效的线程上下文访问它。 Freezable 继承者应在写入非依赖属性的数据成员的任何 API 的开头调用此方法。 (继承自 Freezable)

事件

Changed

在修改 Freezable 或其包含的对象时发生。

(继承自 Freezable)

适用于

通过

GlyphRunDrawing 类

定义

示例

注解

构造函数

字段

属性

方法

事件

适用于

反馈

其他资源