GlyphRunDrawing Kelas

Definisi

Ruang nama:

System.Windows.Media

Rakitan:

PresentationCore.dll

Mewakili objek Drawing yang merender GlyphRun.

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

Warisan

Object

DispatcherObject

DependencyObject

Freezable

Animatable

Drawing

GlyphRunDrawing

Contoh

Contoh berikut menggunakan GlyphRunDrawing untuk menggambar teks "Halo Dunia".

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 adalah objek tingkat rendah yang ditujukan untuk digunakan dengan presentasi dokumen format tetap dan skenario cetak. Cara yang lebih sederhana untuk menggambar teks ke layar adalah dengan menggunakan Label atau TextBlock. Untuk informasi selengkapnya tentang GlyphRun, lihat Pengenalan GlyphRun Object and Glyphs Element gambaran umum.

Keterangan

Objek GlyphRun mewakili urutan glyph dari satu wajah font tunggal pada satu ukuran, dan dengan satu gaya penyajian.

GlyphRun berisi detail font seperti indeks glyph dan posisi glyph individual. Selain itu, GlyphRun berisi titik kode Unicode asli yang dihasilkan dari, karakter ke informasi pemetaan offset buffer glyph, dan bendera per karakter dan per glyph.

Setiap glyph dalam GlyphRun mendefinisikan metrik yang menentukan bagaimana glyph selaras dengan Glyphslainnya. Grafik berikut mendefinisikan berbagai kualitas tipografi dari dua karakter glyph yang berbeda.

Berbagai kualitas tipografi dari dua karakter glyph yang berbeda

Fitur Freezable: A GlyphRunDrawing adalah jenis objek Freezable dan oleh karena itu dapat dibekukan untuk meningkatkan performa. Untuk informasi tentang fitur Freezable, seperti pembekuan dan kloning, lihat Gambaran Umum Objek yang Dapat Dibekukan .

Perhatian: objekGlyphRunDrawing tidak mendukung eksekusi kepercayaan parsial. Aplikasi harus memiliki izin kepercayaan penuh untuk menggunakan objek GlyphRunDrawing.

Konstruktor

GlyphRunDrawing()	Menginisialisasi instans baru kelas GlyphRunDrawing.
GlyphRunDrawing(Brush, GlyphRun)	Menginisialisasi instans baru kelas GlyphRunDrawing dengan menentukan kuas latar depan dan GlyphRun.

Bidang

ForegroundBrushProperty	Mengidentifikasi properti dependensi ForegroundBrush.
GlyphRunProperty	Mengidentifikasi properti dependensi GlyphRun.

Properti

Bounds	Mendapatkan batas konten gambar yang selaras dengan sumbu. (Diperoleh dari Drawing)
CanFreeze	Mendapatkan nilai yang menunjukkan apakah objek dapat dibuat tidak dapat dimodifikasi. (Diperoleh dari Freezable)
DependencyObjectType	Mendapatkan DependencyObjectType yang membungkus jenis CLR instans ini. (Diperoleh dari DependencyObject)
Dispatcher	Mendapatkan DispatcherDispatcherObject ini dikaitkan. (Diperoleh dari DispatcherObject)
ForegroundBrush	Mendapatkan atau mengatur kuas latar depan GlyphRunDrawing.
GlyphRun	Mendapatkan atau mengatur GlyphRun yang menjelaskan teks yang akan digambar.
HasAnimatedProperties	Mendapatkan nilai yang menunjukkan apakah satu atau beberapa objek AnimationClock dikaitkan dengan salah satu properti dependensi objek ini. (Diperoleh dari Animatable)
IsFrozen	Mendapatkan nilai yang menunjukkan apakah objek saat ini dapat dimodifikasi. (Diperoleh dari Freezable)
IsSealed	Mendapatkan nilai yang menunjukkan apakah instans ini saat ini disegel (baca-saja). (Diperoleh dari DependencyObject)

Metode

ApplyAnimationClock(DependencyProperty, AnimationClock)	Menerapkan AnimationClock ke DependencyPropertyyang ditentukan. Jika properti sudah dianimasikan, perilaku handoff SnapshotAndReplace digunakan. (Diperoleh dari Animatable)
ApplyAnimationClock(DependencyProperty, AnimationClock, HandoffBehavior)	Menerapkan AnimationClock ke DependencyPropertyyang ditentukan. Jika properti sudah dianimasikan, HandoffBehavior yang ditentukan akan digunakan. (Diperoleh dari Animatable)
BeginAnimation(DependencyProperty, AnimationTimeline)	Menerapkan animasi ke DependencyPropertyyang ditentukan. Animasi dimulai ketika bingkai berikutnya dirender. Jika properti yang ditentukan sudah dianimasikan, perilaku handoff SnapshotAndReplace digunakan. (Diperoleh dari Animatable)
BeginAnimation(DependencyProperty, AnimationTimeline, HandoffBehavior)	Menerapkan animasi ke DependencyPropertyyang ditentukan. Animasi dimulai ketika bingkai berikutnya dirender. Jika properti yang ditentukan sudah dianimasikan, HandoffBehavior yang ditentukan akan digunakan. (Diperoleh dari Animatable)
CheckAccess()	Menentukan apakah utas panggilan memiliki akses ke DispatcherObjectini. (Diperoleh dari DispatcherObject)
ClearValue(DependencyProperty)	Menghapus nilai lokal properti. Properti yang akan dihapus ditentukan oleh pengidentifikasi DependencyProperty. (Diperoleh dari DependencyObject)
ClearValue(DependencyPropertyKey)	Menghapus nilai lokal properti baca-saja. Properti yang akan dihapus ditentukan oleh DependencyPropertyKey. (Diperoleh dari DependencyObject)
Clone()	Membuat kloning yang dapat dimodifikasi dari GlyphRunDrawingini , membuat salinan mendalam dari nilai objek ini. Saat menyalin properti dependensi, metode ini menyalin referensi sumber daya dan pengikatan data (tetapi mungkin tidak lagi diselesaikan) tetapi bukan animasi atau nilainya saat ini.
CloneCore(Freezable)	Menjadikan instans sebagai kloning (salinan mendalam) dari Freezable yang ditentukan menggunakan nilai properti dasar (non-animasi). (Diperoleh dari Freezable)
CloneCurrentValue()	Membuat klon yang dapat dimodifikasi dari objek GlyphRunDrawing ini, membuat salinan mendalam dari nilai objek ini saat ini. Referensi sumber daya, pengikatan data, dan animasi tidak disalin, tetapi nilainya saat ini.
CloneCurrentValueCore(Freezable)	Menjadikan instans sebagai kloning yang dapat dimodifikasi (salinan mendalam) dari Freezable yang ditentukan menggunakan nilai properti saat ini. (Diperoleh dari Freezable)
CoerceValue(DependencyProperty)	Memaksa nilai properti dependensi yang ditentukan. Ini dicapai dengan memanggil fungsi CoerceValueCallback apa pun yang ditentukan dalam metadata properti untuk properti dependensi karena ada pada panggilan DependencyObject. (Diperoleh dari DependencyObject)
CreateInstance()	Menginisialisasi instans baru kelas Freezable. (Diperoleh dari Freezable)
CreateInstanceCore()	Saat diimplementasikan dalam kelas turunan, membuat instans baru dari kelas turunan Freezable. (Diperoleh dari Freezable)
Equals(Object)	Menentukan apakah DependencyObject yang disediakan setara dengan DependencyObjectsaat ini. (Diperoleh dari DependencyObject)
Freeze()	Membuat objek saat ini tidak dapat dimodifikasi dan mengatur properti IsFrozen ke true. (Diperoleh dari Freezable)
FreezeCore(Boolean)	Membuat objek Animatable ini tidak dapat dimodifikasi atau menentukan apakah objek dapat dibuat tidak dapat dimodifikasi. (Diperoleh dari Animatable)
GetAnimationBaseValue(DependencyProperty)	Mengembalikan nilai non-animasi dari DependencyPropertyyang ditentukan . (Diperoleh dari Animatable)
GetAsFrozen()	Membuat salinan beku Freezable, menggunakan nilai properti dasar (non-animasi). Karena salinan dibekukan, sub-objek beku apa pun disalin oleh referensi. (Diperoleh dari Freezable)
GetAsFrozenCore(Freezable)	Menjadikan instans sebagai klon beku dari Freezable yang ditentukan menggunakan nilai properti dasar (non-animasi). (Diperoleh dari Freezable)
GetCurrentValueAsFrozen()	Membuat salinan beku Freezable menggunakan nilai properti saat ini. Karena salinan dibekukan, sub-objek beku apa pun disalin oleh referensi. (Diperoleh dari Freezable)
GetCurrentValueAsFrozenCore(Freezable)	Menjadikan instans saat ini sebagai klon beku dari Freezableyang ditentukan . Jika objek memiliki properti dependensi animasi, nilai animasinya saat ini akan disalin. (Diperoleh dari Freezable)
GetHashCode()	Mendapatkan kode hash untuk DependencyObjectini. (Diperoleh dari DependencyObject)
GetLocalValueEnumerator()	Membuat enumerator khusus untuk menentukan properti dependensi mana yang telah mengatur nilai secara lokal pada DependencyObjectini. (Diperoleh dari DependencyObject)
GetType()	Mendapatkan Type instans saat ini. (Diperoleh dari Object)
GetValue(DependencyProperty)	Mengembalikan nilai efektif properti dependensi saat ini pada instans DependencyObjectini. (Diperoleh dari DependencyObject)
InvalidateProperty(DependencyProperty)	Mengevaluasi kembali nilai efektif untuk properti dependensi yang ditentukan. (Diperoleh dari DependencyObject)
MemberwiseClone()	Membuat salinan dangkal dari Objectsaat ini. (Diperoleh dari Object)
OnChanged()	Dipanggil ketika objek Freezable saat ini dimodifikasi. (Diperoleh dari Freezable)
OnFreezablePropertyChanged(DependencyObject, DependencyObject)	Memastikan bahwa penunjuk konteks yang sesuai ditetapkan untuk anggota data DependencyObjectType yang baru saja ditetapkan. (Diperoleh dari Freezable)
OnFreezablePropertyChanged(DependencyObject, DependencyObject, DependencyProperty)	Anggota ini mendukung infrastruktur Windows Presentation Foundation (WPF) dan tidak dimaksudkan untuk digunakan langsung dari kode Anda. (Diperoleh dari Freezable)
OnPropertyChanged(DependencyPropertyChangedEventArgs)	Mengambil alih implementasi OnPropertyChanged(DependencyPropertyChangedEventArgs)DependencyObject untuk juga memanggil penangan Changed sebagai respons terhadap properti dependensi yang berubah dari jenis Freezable. (Diperoleh dari Freezable)
ReadLocalValue(DependencyProperty)	Mengembalikan nilai lokal properti dependensi, jika ada. (Diperoleh dari DependencyObject)
ReadPreamble()	Memastikan bahwa Freezable sedang diakses dari utas yang valid. Pewaris Freezable harus memanggil metode ini di awal API apa pun yang membaca anggota data yang bukan properti dependensi. (Diperoleh dari Freezable)
SetCurrentValue(DependencyProperty, Object)	Mengatur nilai properti dependensi tanpa mengubah sumber nilainya. (Diperoleh dari DependencyObject)
SetValue(DependencyProperty, Object)	Mengatur nilai lokal properti dependensi, yang ditentukan oleh pengidentifikasi properti dependensinya. (Diperoleh dari DependencyObject)
SetValue(DependencyPropertyKey, Object)	Mengatur nilai lokal properti dependensi baca-saja, yang ditentukan oleh pengidentifikasi DependencyPropertyKey properti dependensi. (Diperoleh dari DependencyObject)
ShouldSerializeProperty(DependencyProperty)	Mengembalikan nilai yang menunjukkan apakah proses serialisasi harus membuat serialisasi nilai untuk properti dependensi yang disediakan. (Diperoleh dari DependencyObject)
ToString()	Mengembalikan string yang mewakili objek saat ini. (Diperoleh dari Object)
VerifyAccess()	Memberlakukan bahwa utas panggilan memiliki akses ke DispatcherObjectini . (Diperoleh dari DispatcherObject)
WritePostscript()	Menaikkan peristiwa Changed untuk Freezable dan memanggil metode OnChanged(). Kelas yang berasal dari Freezable harus memanggil metode ini di akhir API apa pun yang memodifikasi anggota kelas yang tidak disimpan sebagai properti dependensi. (Diperoleh dari Freezable)
WritePreamble()	Memverifikasi bahwa Freezable tidak dibekukan dan diakses dari konteks utas yang valid. Freezable pewaris harus memanggil metode ini di awal API apa pun yang menulis ke anggota data yang bukan properti dependensi. (Diperoleh dari Freezable)

Acara

Changed

Terjadi ketika Freezable atau objek yang dikandungnya dimodifikasi. (Diperoleh dari Freezable)