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);

XAML

<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の詳細については、「GlyphRun オブジェクトと Glyphs 要素の概要概要」を参照してください。

注釈

GlyphRun オブジェクトは、1 つのフォントの単一の面から 1 つのサイズで、1 つのレンダリングスタイルを持つグリフのシーケンスを表します。

GlyphRun には、グリフインデックスや個々のグリフ位置などのフォントの詳細が含まれています。さらに、GlyphRun には、実行元の Unicode コードポイント、文字からグリフバッファーへのオフセットマッピング情報、文字ごとおよびグリフごとのフラグが含まれます。

GlyphRun 内の各グリフは、他の Glyphsとの配置方法を指定するメトリックを定義します。次の図は、2 つの異なるグリフ文字のさまざまな文字体裁を定義しています。

グリフ測定のダイアグラフ
2 つの異なるグリフ文字のさまざまな文字体裁の特性

Freezable Features: A GlyphRunDrawing は Freezable オブジェクトの一種であるため、パフォーマンスを向上させるために固定できます。フリーズや複製などの機能の詳細については、「freezable Objects Overviewを参照してください。

注意: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	1 つ以上の AnimationClock オブジェクトがこのオブジェクトの依存関係プロパティのいずれかに関連付けられているかどうかを示す値を取得します。 (継承元 Animatable)
IsFrozen	オブジェクトが現在変更可能かどうかを示す値を取得します。 (継承元 Freezable)
IsSealed	このインスタンスが現在シールされているかどうかを示す値を取得します (読み取り専用)。 (継承元 DependencyObject)

メソッド

ApplyAnimationClock(DependencyProperty, AnimationClock)	指定した DependencyPropertyに AnimationClock を適用します。プロパティが既にアニメーション化されている場合は、SnapshotAndReplace ハンドオフ動作が使用されます。 (継承元 Animatable)
ApplyAnimationClock(DependencyProperty, AnimationClock, HandoffBehavior)	指定した DependencyPropertyに AnimationClock を適用します。プロパティが既にアニメーション化されている場合は、指定した 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 実装をオーバーライドして、Freezable型の依存関係プロパティの変化に応じて Changed ハンドラーも呼び出します。 (継承元 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)

適用対象

製品	バージョン
.NET Framework	3.0, 3.5, 4.0, 4.5, 4.5.1, 4.5.2, 4.6, 4.6.1, 4.6.2, 4.7, 4.7.1, 4.7.2, 4.8, 4.8.1
Windows Desktop	3.0, 3.1, 5, 6, 7, 8, 9

次の方法で共有