GlyphRunDrawing Klasa

Definicja

Przestrzeń nazw:

System.Windows.Media

Zestaw:

PresentationCore.dll

Reprezentuje obiekt Drawing, który renderuje 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

Dziedziczenie

Object

DispatcherObject

DependencyObject

Freezable

Animatable

Drawing

GlyphRunDrawing

Przykłady

W poniższym przykładzie użyto GlyphRunDrawing, aby narysować tekst "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 jest obiektem niskiego poziomu przeznaczonym do użytku ze scenariuszami prezentacji i drukowania dokumentów w formacie stałym. Prostszą metodą rysowania tekstu na ekranie jest użycie Label lub TextBlock. Aby uzyskać więcej informacji na temat GlyphRun, zobacz omówienie Introduction to the GlyphRun Object and Glyphs, element .

Uwagi

Obiekt GlyphRun reprezentuje sekwencję glifów z jednej twarzy pojedynczej czcionki o pojedynczym rozmiarze i jednym stylem renderowania.

GlyphRun zawiera szczegóły czcionek, takie jak indeksy glifów i poszczególne pozycje glifów. Ponadto GlyphRun zawiera oryginalne punkty kodu Unicode, z których został wygenerowany przebieg, znak na informacje mapowania przesunięcia bufora glyph oraz flagi na znak i na glyph.

Każdy glyph w GlyphRun definiuje metryki określające, w jaki sposób jest on zgodny z innymi Glyphs. Poniższa grafika definiuje różne cechy typograficzne dwóch różnych znaków glifów.

Różne cechy typograficzne dwóch różnych znaków glifów

funkcji zamrażalnych: A GlyphRunDrawing jest typem obiektu Freezable i dlatego można go zablokować w celu zwiększenia wydajności. Aby uzyskać informacje o funkcjach Freezable, takich jak zamrażanie i klonowanie, zobacz Obiekty zamrażalne — omówienie.

Przestroga: obiektyGlyphRunDrawing nie obsługują częściowego wykonywania zaufania. Aplikacja musi mieć pełne uprawnienia zaufania do używania obiektów GlyphRunDrawing.

Konstruktory

GlyphRunDrawing()	Inicjuje nowe wystąpienie klasy GlyphRunDrawing.
GlyphRunDrawing(Brush, GlyphRun)	Inicjuje nowe wystąpienie klasy GlyphRunDrawing, określając szczotkę pierwszego planu i GlyphRun.

Pola

ForegroundBrushProperty	Identyfikuje właściwość zależności ForegroundBrush.
GlyphRunProperty	Identyfikuje właściwość zależności GlyphRun.

Właściwości

Bounds	Pobiera wyrównane do osi granice zawartości rysunku. (Odziedziczone po Drawing)
CanFreeze	Pobiera wartość wskazującą, czy obiekt może być niezmodyfikowalny. (Odziedziczone po Freezable)
DependencyObjectType	Pobiera DependencyObjectType, który opakowuje typ CLR tego wystąpienia. (Odziedziczone po DependencyObject)
Dispatcher	Pobiera Dispatcher jest skojarzony z tym DispatcherObject. (Odziedziczone po DispatcherObject)
ForegroundBrush	Pobiera lub ustawia pędzel pierwszego planu GlyphRunDrawing.
GlyphRun	Pobiera lub ustawia GlyphRun opisujący tekst do rysowania.
HasAnimatedProperties	Pobiera wartość wskazującą, czy co najmniej jeden obiekt AnimationClock jest skojarzony z dowolnymi właściwościami zależności tego obiektu. (Odziedziczone po Animatable)
IsFrozen	Pobiera wartość wskazującą, czy obiekt jest obecnie modyfikowalny. (Odziedziczone po Freezable)
IsSealed	Pobiera wartość wskazującą, czy to wystąpienie jest obecnie zapieczętowane (tylko do odczytu). (Odziedziczone po DependencyObject)

Metody

ApplyAnimationClock(DependencyProperty, AnimationClock)	Stosuje AnimationClock do określonego DependencyProperty. Jeśli właściwość jest już animowana, używane jest zachowanie przekazywania SnapshotAndReplace. (Odziedziczone po Animatable)
ApplyAnimationClock(DependencyProperty, AnimationClock, HandoffBehavior)	Stosuje AnimationClock do określonego DependencyProperty. Jeśli właściwość jest już animowana, zostanie użyta określona HandoffBehavior. (Odziedziczone po Animatable)
BeginAnimation(DependencyProperty, AnimationTimeline)	Stosuje animację do określonego DependencyProperty. Animacja jest uruchamiana po renderowaniu następnej ramki. Jeśli określona właściwość jest już animowana, zostanie użyte zachowanie przekazywania SnapshotAndReplace. (Odziedziczone po Animatable)
BeginAnimation(DependencyProperty, AnimationTimeline, HandoffBehavior)	Stosuje animację do określonego DependencyProperty. Animacja jest uruchamiana po renderowaniu następnej ramki. Jeśli określona właściwość jest już animowana, zostanie użyta określona HandoffBehavior. (Odziedziczone po Animatable)
CheckAccess()	Określa, czy wątek wywołujący ma dostęp do tego DispatcherObject. (Odziedziczone po DispatcherObject)
ClearValue(DependencyProperty)	Czyści wartość lokalną właściwości. Właściwość do wyczyszczenia jest określana przez identyfikator DependencyProperty. (Odziedziczone po DependencyObject)
ClearValue(DependencyPropertyKey)	Czyści wartość lokalną właściwości tylko do odczytu. Właściwość do wyczyszczenia jest określana przez DependencyPropertyKey. (Odziedziczone po DependencyObject)
Clone()	Tworzy modyfikowalny klon tego GlyphRunDrawing, tworząc głębokie kopie wartości tego obiektu. Podczas kopiowania właściwości zależności ta metoda kopiuje odwołania do zasobów i powiązania danych (ale mogą nie być już rozpoznawane), ale nie animacje ani ich bieżące wartości.
CloneCore(Freezable)	Sprawia, że wystąpienie jest klonem (kopia głęboka) określonego Freezable przy użyciu wartości właściwości base (nie animowanych). (Odziedziczone po Freezable)
CloneCurrentValue()	Tworzy modyfikowalny klon tego obiektu GlyphRunDrawing, tworząc głębokie kopie bieżących wartości tego obiektu. Odwołania do zasobów, powiązania danych i animacje nie są kopiowane, ale ich bieżące wartości są.
CloneCurrentValueCore(Freezable)	Sprawia, że wystąpienie jest modyfikowalnym klonem (kopia głęboka) określonego Freezable przy użyciu bieżących wartości właściwości. (Odziedziczone po Freezable)
CoerceValue(DependencyProperty)	Przekształca wartość określonej właściwości zależności. Jest to realizowane przez wywołanie dowolnej funkcji CoerceValueCallback określonej w metadanych właściwości dla właściwości, ponieważ istnieje w wywołaniu DependencyObject. (Odziedziczone po DependencyObject)
CreateInstance()	Inicjuje nowe wystąpienie klasy Freezable. (Odziedziczone po Freezable)
CreateInstanceCore()	Po zaimplementowaniu w klasie pochodnej tworzy nowe wystąpienie klasy pochodnej Freezable. (Odziedziczone po Freezable)
Equals(Object)	Określa, czy podany DependencyObject jest odpowiednikiem bieżącego DependencyObject. (Odziedziczone po DependencyObject)
Freeze()	Sprawia, że bieżący obiekt jest niezmodyfikowalny i ustawia jego właściwość IsFrozen na true. (Odziedziczone po Freezable)
FreezeCore(Boolean)	Sprawia, że ten obiekt Animatable niezmodyfikowalny lub określa, czy można go zmodyfikować. (Odziedziczone po Animatable)
GetAnimationBaseValue(DependencyProperty)	Zwraca nie animowaną wartość określonego DependencyProperty. (Odziedziczone po Animatable)
GetAsFrozen()	Tworzy zamrożoną kopię Freezable, używając wartości właściwości base (nie animowanych). Ponieważ kopia jest zamrożona, wszystkie zamrożone obiekty podrzędne są kopiowane przez odwołanie. (Odziedziczone po Freezable)
GetAsFrozenCore(Freezable)	Sprawia, że wystąpienie jest zamrożonym klonem określonego Freezable przy użyciu wartości właściwości base (nie animowanych). (Odziedziczone po Freezable)
GetCurrentValueAsFrozen()	Tworzy zamrożoną kopię Freezable przy użyciu bieżących wartości właściwości. Ponieważ kopia jest zamrożona, wszystkie zamrożone obiekty podrzędne są kopiowane przez odwołanie. (Odziedziczone po Freezable)
GetCurrentValueAsFrozenCore(Freezable)	Powoduje, że bieżące wystąpienie jest klonem zamrożonym określonego Freezable. Jeśli obiekt ma animowane właściwości zależności, zostaną skopiowane ich bieżące animowane wartości. (Odziedziczone po Freezable)
GetHashCode()	Pobiera kod skrótu dla tego DependencyObject. (Odziedziczone po DependencyObject)
GetLocalValueEnumerator()	Tworzy wyspecjalizowany moduł wyliczający do określania, które właściwości zależności mają lokalnie ustawione wartości na tym DependencyObject. (Odziedziczone po DependencyObject)
GetType()	Pobiera Type bieżącego wystąpienia. (Odziedziczone po Object)
GetValue(DependencyProperty)	Zwraca bieżącą obowiązującą wartość właściwości zależności dla tego wystąpienia DependencyObject. (Odziedziczone po DependencyObject)
InvalidateProperty(DependencyProperty)	Ponownie oblicza obowiązującą wartość dla określonej właściwości zależności. (Odziedziczone po DependencyObject)
MemberwiseClone()	Tworzy płytkią kopię bieżącego Object. (Odziedziczone po Object)
OnChanged()	Wywoływana po zmodyfikowaniu bieżącego obiektu Freezable. (Odziedziczone po Freezable)
OnFreezablePropertyChanged(DependencyObject, DependencyObject)	Zapewnia, że odpowiednie wskaźniki kontekstu są ustanawiane dla DependencyObjectType elementu członkowskiego danych, który właśnie został ustawiony. (Odziedziczone po Freezable)
OnFreezablePropertyChanged(DependencyObject, DependencyObject, DependencyProperty)	Ten element członkowski obsługuje infrastrukturę programu Windows Presentation Foundation (WPF) i nie ma być używany bezpośrednio z kodu. (Odziedziczone po Freezable)
OnPropertyChanged(DependencyPropertyChangedEventArgs)	Zastępuje implementację DependencyObjectOnPropertyChanged(DependencyPropertyChangedEventArgs), aby również wywoływać wszystkie programy obsługi Changed w odpowiedzi na zmieniającą się właściwość zależności typu Freezable. (Odziedziczone po Freezable)
ReadLocalValue(DependencyProperty)	Zwraca wartość lokalną właściwości zależności, jeśli istnieje. (Odziedziczone po DependencyObject)
ReadPreamble()	Gwarantuje, że dostęp do Freezable jest uzyskiwany z prawidłowego wątku. Dziedziczy Freezable muszą wywoływać tę metodę na początku dowolnego interfejsu API, który odczytuje elementy członkowskie danych, które nie są właściwościami zależności. (Odziedziczone po Freezable)
SetCurrentValue(DependencyProperty, Object)	Ustawia wartość właściwości zależności bez zmieniania źródła wartości. (Odziedziczone po DependencyObject)
SetValue(DependencyProperty, Object)	Ustawia wartość lokalną właściwości zależności określonej przez jej identyfikator właściwości zależności. (Odziedziczone po DependencyObject)
SetValue(DependencyPropertyKey, Object)	Ustawia wartość lokalną właściwości zależności tylko do odczytu określoną przez identyfikator DependencyPropertyKey właściwości zależności. (Odziedziczone po DependencyObject)
ShouldSerializeProperty(DependencyProperty)	Zwraca wartość wskazującą, czy procesy serializacji powinny serializować wartość podanej właściwości zależności. (Odziedziczone po DependencyObject)
ToString()	Zwraca ciąg reprezentujący bieżący obiekt. (Odziedziczone po Object)
VerifyAccess()	Wymusza, że wątek wywołujący ma dostęp do tego DispatcherObject. (Odziedziczone po DispatcherObject)
WritePostscript()	Wywołuje zdarzenie Changed dla Freezable i wywołuje jego metodę OnChanged(). Klasy pochodzące z Freezable powinny wywoływać tę metodę na końcu dowolnego interfejsu API, który modyfikuje składowe klasy, które nie są przechowywane jako właściwości zależności. (Odziedziczone po Freezable)
WritePreamble()	Sprawdza, czy Freezable nie jest zamrożona i czy jest uzyskiwany dostęp z prawidłowego kontekstu wątkowego. Freezable dziedziczy powinny wywoływać tę metodę na początku dowolnego interfejsu API, który zapisuje dane członkom, które nie są właściwościami zależności. (Odziedziczone po Freezable)

Zdarzenia

Changed

Występuje, gdy Freezable lub obiekt, który zawiera, jest modyfikowany. (Odziedziczone po Freezable)