GlyphRunDrawing Klasse

Definition

Namespace:

System.Windows.Media

Assembly:

PresentationCore.dll

Stellt ein Drawing -Objekt dar, das eine GlyphRunrendert.

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

Vererbung

Object

DispatcherObject

DependencyObject

Freezable

Animatable

Drawing

GlyphRunDrawing

Beispiele

Im folgenden Beispiel wird ein GlyphRunDrawing verwendet, um den Text "Hello World" zu zeichnen.

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>

Ein GlyphRun ist ein Objekt auf niedriger Ebene, das für die Verwendung mit Präsentation und Druckszenarien mit festem Format vorgesehen ist. Eine einfachere Möglichkeit zum Zeichnen von Text auf dem Bildschirm ist die Verwendung eines Label oder eines TextBlock. Weitere Informationen zu GlyphRunfinden Sie in der Übersicht über das Introduction to the GlyphRun Object and Glyphs Element overview.

Hinweise

Das GlyphRun-Objekt stellt eine Sequenz von Glyphen aus einer einzelnen Schriftart in einem einzigen Schriftgrad und mit einem einzelnen Renderingstil dar.

GlyphRun enthält Schriftdetails wie Glyphenindizes und einzelne Glyphenpositionen. Darüber hinaus enthält GlyphRun die ursprünglichen Unicode-Codepunkte, aus denen die Ausführung generiert wurde, Zeichen zu Glyphenpuffer-Offsetzuordnungsinformationen sowie Pro-Zeichen- und Glyphen-Flags.

Jede Glyphe in einer GlyphRun definiert Metriken, die angeben, wie sie mit anderen Glyphsausgerichtet wird. Die folgende Grafik definiert die verschiedenen typografischen Eigenschaften von zwei verschiedenen Glyphenzeichen.

Verschiedene typografische Qualitäten von zwei unterschiedlichen Glyphenzeichen

Freistellbare Features: Ein GlyphRunDrawing ist eine Art von Freezable Objekt und kann daher eingefroren werden, um die Leistung zu verbessern. Informationen zu Freezable Features wie Einfrieren und Klonen finden Sie in der Übersicht über Freezable Objects.

Vorsicht:GlyphRunDrawing Objekte unterstützen keine teilweise vertrauenswürdige Ausführung. Eine Anwendung muss über voll vertrauenswürdige Berechtigungen verfügen, um GlyphRunDrawing Objekte zu verwenden.

Konstruktoren

GlyphRunDrawing()	Initialisiert eine neue Instanz der GlyphRunDrawing Klasse.
GlyphRunDrawing(Brush, GlyphRun)	Initialisiert eine neue Instanz der GlyphRunDrawing Klasse durch Angeben des Vordergrundpinsels und GlyphRun.

Felder

ForegroundBrushProperty	Identifies the ForegroundBrush dependency property.
GlyphRunProperty	Identifies the GlyphRun dependency property.

Eigenschaften

Bounds	Ruft die achsenbündigen Begrenzungen des Zeichnungsinhalts ab. (Geerbt von Drawing)
CanFreeze	Ruft einen Wert ab, der angibt, ob das Objekt unveränderlich gemacht werden kann. (Geerbt von Freezable)
DependencyObjectType	Ruft die DependencyObjectType ab, die den CLR-Typ dieser Instanz umschließt. (Geerbt von DependencyObject)
Dispatcher	Ruft die Dispatcher dieser DispatcherObject zugeordnet ist. (Geerbt von DispatcherObject)
ForegroundBrush	Dient zum Abrufen oder Festlegen des Vordergrundpinsels der GlyphRunDrawing.
GlyphRun	Ruft die GlyphRun ab, die den zu zeichnenden Text beschreibt, oder legt diesen fest.
HasAnimatedProperties	Ruft einen Wert ab, der angibt, ob ein oder mehrere AnimationClock Objekte den Abhängigkeitseigenschaften dieses Objekts zugeordnet sind. (Geerbt von Animatable)
IsFrozen	Ruft einen Wert ab, der angibt, ob das Objekt derzeit geändert werden kann. (Geerbt von Freezable)
IsSealed	Ruft einen Wert ab, der angibt, ob diese Instanz aktuell versiegelt ist (schreibgeschützt). (Geerbt von DependencyObject)

Methoden

ApplyAnimationClock(DependencyProperty, AnimationClock)	Wendet eine AnimationClock auf die angegebene DependencyPropertyan. Wenn die Eigenschaft bereits animiert ist, wird das SnapshotAndReplace Handoffverhalten verwendet. (Geerbt von Animatable)
ApplyAnimationClock(DependencyProperty, AnimationClock, HandoffBehavior)	Wendet eine AnimationClock auf die angegebene DependencyPropertyan. Wenn die Eigenschaft bereits animiert ist, wird die angegebene HandoffBehavior verwendet. (Geerbt von Animatable)
BeginAnimation(DependencyProperty, AnimationTimeline)	Wendet eine Animation auf die angegebene DependencyPropertyan. Die Animation wird gestartet, wenn der nächste Frame gerendert wird. Wenn die angegebene Eigenschaft bereits animiert ist, wird das SnapshotAndReplace Handoffverhalten verwendet. (Geerbt von Animatable)
BeginAnimation(DependencyProperty, AnimationTimeline, HandoffBehavior)	Wendet eine Animation auf die angegebene DependencyPropertyan. Die Animation wird gestartet, wenn der nächste Frame gerendert wird. Wenn die angegebene Eigenschaft bereits animiert ist, wird die angegebene HandoffBehavior verwendet. (Geerbt von Animatable)
CheckAccess()	Bestimmt, ob der aufrufende Thread Zugriff auf diese DispatcherObjecthat. (Geerbt von DispatcherObject)
ClearValue(DependencyProperty)	Löscht den lokalen Wert einer Eigenschaft. Die zu löschende Eigenschaft wird durch einen DependencyProperty Bezeichner angegeben. (Geerbt von DependencyObject)
ClearValue(DependencyPropertyKey)	Löscht den lokalen Wert einer schreibgeschützten Eigenschaft. Die zu löschende Eigenschaft wird durch eine DependencyPropertyKeyangegeben. (Geerbt von DependencyObject)
Clone()	Erstellt einen modifizierbaren Klon dieser GlyphRunDrawing, wodurch tiefe Kopien der Werte dieses Objekts erstellt werden. Beim Kopieren von Abhängigkeitseigenschaften kopiert diese Methode Ressourcenverweise und Datenbindungen (aber möglicherweise nicht mehr auflösen), jedoch keine Animationen oder ihre aktuellen Werte.
CloneCore(Freezable)	Macht die Instanz zu einem Klon (deep copy) der angegebenen Freezable unter Verwendung von Basiseigenschaftenwerten (nicht animiert). (Geerbt von Freezable)
CloneCurrentValue()	Erstellt einen modifizierbaren Klon dieses GlyphRunDrawing-Objekts, wodurch tiefe Kopien der aktuellen Werte dieses Objekts erstellt werden. Ressourcenverweise, Datenbindungen und Animationen werden nicht kopiert, aber ihre aktuellen Werte sind.
CloneCurrentValueCore(Freezable)	Macht die Instanz zu einem modifizierbaren Klon (deep copy) des angegebenen Freezable mit aktuellen Eigenschaftswerten. (Geerbt von Freezable)
CoerceValue(DependencyProperty)	Wandelt den Wert der angegebenen Abhängigkeitseigenschaft um. Dies wird erreicht, indem alle in Eigenschaftsmetadaten für die Abhängigkeitseigenschaft angegebenen CoerceValueCallback Funktion aufgerufen werden, wie sie für die aufrufende DependencyObjectvorhanden ist. (Geerbt von DependencyObject)
CreateInstance()	Initialisiert eine neue Instanz der Freezable Klasse. (Geerbt von Freezable)
CreateInstanceCore()	Wenn sie in einer abgeleiteten Klasse implementiert wird, wird eine neue Instanz der Freezable abgeleiteten Klasse erstellt. (Geerbt von Freezable)
Equals(Object)	Bestimmt, ob eine angegebene DependencyObject dem aktuellen DependencyObjectentspricht. (Geerbt von DependencyObject)
Freeze()	Macht das aktuelle Objekt unveränderlich und legt seine IsFrozen Eigenschaft auf truefest. (Geerbt von Freezable)
FreezeCore(Boolean)	Macht dieses Animatable Objekt unveränderlich oder bestimmt, ob es unveränderlich gemacht werden kann. (Geerbt von Animatable)
GetAnimationBaseValue(DependencyProperty)	Gibt den nicht animierten Wert des angegebenen DependencyPropertyzurück. (Geerbt von Animatable)
GetAsFrozen()	Erstellt eine fixierte Kopie der Freezablemithilfe von Basiseigenschaftenwerten (nicht animiert). Da die Kopie fixiert ist, werden alle fixierten Unterobjekte per Verweis kopiert. (Geerbt von Freezable)
GetAsFrozenCore(Freezable)	Macht die Instanz zu einem fixierten Klon der angegebenen Freezable unter Verwendung von Basiseigenschaftenwerten (nicht animiert). (Geerbt von Freezable)
GetCurrentValueAsFrozen()	Erstellt eine fixierte Kopie der Freezable mit aktuellen Eigenschaftswerten. Da die Kopie fixiert ist, werden alle fixierten Unterobjekte per Verweis kopiert. (Geerbt von Freezable)
GetCurrentValueAsFrozenCore(Freezable)	Macht die aktuelle Instanz zu einem fixierten Klon des angegebenen Freezable. Wenn das Objekt animierte Abhängigkeitseigenschaften aufweist, werden die aktuellen animierten Werte kopiert. (Geerbt von Freezable)
GetHashCode()	Ruft einen Hashcode für diese DependencyObjectab. (Geerbt von DependencyObject)
GetLocalValueEnumerator()	Erstellt einen speziellen Enumerator zum Bestimmen, welche Abhängigkeitseigenschaften lokal für dieses DependencyObjectfestgelegt sind. (Geerbt von DependencyObject)
GetType()	Ruft die Type der aktuellen Instanz ab. (Geerbt von Object)
GetValue(DependencyProperty)	Gibt den aktuellen effektiven Wert einer Abhängigkeitseigenschaft für diese Instanz eines DependencyObjectzurück. (Geerbt von DependencyObject)
InvalidateProperty(DependencyProperty)	Wertet den effektiven Wert für die angegebene Abhängigkeitseigenschaft erneut aus. (Geerbt von DependencyObject)
MemberwiseClone()	Erstellt eine flache Kopie der aktuellen Object. (Geerbt von Object)
OnChanged()	Wird aufgerufen, wenn das aktuelle Freezable-Objekt geändert wird. (Geerbt von Freezable)
OnFreezablePropertyChanged(DependencyObject, DependencyObject)	Stellt sicher, dass geeignete Kontextzeiger für ein soeben festgelegtes DependencyObjectType-Datenmemm eingerichtet werden. (Geerbt von Freezable)
OnFreezablePropertyChanged(DependencyObject, DependencyObject, DependencyProperty)	Dieses Mitglied unterstützt die Windows Presentation Foundation (WPF)-Infrastruktur und ist nicht für die direkte Verwendung aus Ihrem Code vorgesehen. (Geerbt von Freezable)
OnPropertyChanged(DependencyPropertyChangedEventArgs)	Überschreibt die DependencyObject Implementierung von OnPropertyChanged(DependencyPropertyChangedEventArgs), um auch alle Changed Handler als Reaktion auf eine sich ändernde Abhängigkeitseigenschaft vom Typ Freezableaufzurufen. (Geerbt von Freezable)
ReadLocalValue(DependencyProperty)	Gibt den lokalen Wert einer Abhängigkeitseigenschaft zurück, sofern vorhanden. (Geerbt von DependencyObject)
ReadPreamble()	Stellt sicher, dass über einen gültigen Thread auf die Freezable zugegriffen wird. Vererbungen von Freezable müssen diese Methode am Anfang einer API aufrufen, die Datenmber liest, die keine Abhängigkeitseigenschaften sind. (Geerbt von Freezable)
SetCurrentValue(DependencyProperty, Object)	Legt den Wert einer Abhängigkeitseigenschaft fest, ohne die Wertquelle zu ändern. (Geerbt von DependencyObject)
SetValue(DependencyProperty, Object)	Legt den lokalen Wert einer Abhängigkeitseigenschaft fest, die durch den Bezeichner der Abhängigkeitseigenschaft angegeben wird. (Geerbt von DependencyObject)
SetValue(DependencyPropertyKey, Object)	Legt den lokalen Wert einer schreibgeschützten Abhängigkeitseigenschaft fest, die durch den DependencyPropertyKey Bezeichner der Abhängigkeitseigenschaft angegeben wird. (Geerbt von DependencyObject)
ShouldSerializeProperty(DependencyProperty)	Gibt einen Wert zurück, der angibt, ob Serialisierungsprozesse den Wert für die bereitgestellte Abhängigkeitseigenschaft serialisieren sollen. (Geerbt von DependencyObject)
ToString()	Gibt eine Zeichenfolge zurück, die das aktuelle Objekt darstellt. (Geerbt von Object)
VerifyAccess()	Erzwingt, dass der aufrufende Thread Zugriff auf diese DispatcherObjecthat. (Geerbt von DispatcherObject)
WritePostscript()	Löst das Changed-Ereignis für das Freezable aus und ruft seine OnChanged()-Methode auf. Klassen, die von Freezable abgeleitet werden, sollten diese Methode am Ende einer API aufrufen, die Klassenmmber ändert, die nicht als Abhängigkeitseigenschaften gespeichert sind. (Geerbt von Freezable)
WritePreamble()	Überprüft, ob der Freezable nicht fixiert ist und über einen gültigen Threadingkontext darauf zugegriffen wird. Freezable Vererbungen sollten diese Methode am Anfang einer API aufrufen, die in Datenmmber schreibt, die keine Abhängigkeitseigenschaften sind. (Geerbt von Freezable)

Ereignisse

Changed

Tritt auf, wenn das Freezable oder ein darin enthaltenes Objekt geändert wird. (Geerbt von Freezable)