GlyphRunDrawing Classe

Definizione

Rappresenta un oggetto Drawing che esegue il rendering di un 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
Ereditarietà

Esempio

Nell'esempio seguente viene utilizzato un GlyphRunDrawing per disegnare il testo "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>

Un GlyphRun è un oggetto di basso livello destinato all'uso con scenari di presentazione e stampa di documenti in formato fisso. Un modo più semplice per disegnare testo sullo schermo consiste nell'usare un Label o un TextBlock. Per altre informazioni su GlyphRun, vedere la panoramica Introduzione all'oggetto GlyphRun e all'elemento Glyphs.

Commenti

L'oggetto GlyphRun rappresenta una sequenza di glifi di un singolo tipo di carattere a una singola dimensione e con un singolo stile di rendering.

GlyphRun contiene dettagli sui tipi di carattere, ad esempio indici di glifi e singole posizioni del glifo. Inoltre, GlyphRun contiene i punti di codice Unicode originali da cui è stata generata l'esecuzione, il carattere alle informazioni di mapping dell'offset del buffer del glifo e i flag per carattere e per glifo.

Ogni glifo in un GlyphRun definisce le metriche che specificano la modalità di allineamento con altre Glyphs. L'immagine seguente definisce le varie qualità tipografiche di due diversi caratteri glifi.

diagrafo delle misurazioni del glifo
Varie qualità tipografiche di due diversi caratteri glifi

Freezable Features: A GlyphRunDrawing è un tipo di oggetto Freezable e pertanto può essere bloccato per migliorare le prestazioni. Per informazioni sulle funzionalità di Freezable, ad esempio il blocco e la clonazione, vedere panoramica degli oggetti freezable .

Attenzione: gli oggettiGlyphRunDrawing non supportano l'esecuzione parziale dell'attendibilità. Un'applicazione deve disporre delle autorizzazioni di attendibilità completa per l'uso di oggetti GlyphRunDrawing.

Costruttori

GlyphRunDrawing()

Inizializza una nuova istanza della classe GlyphRunDrawing.

GlyphRunDrawing(Brush, GlyphRun)

Inizializza una nuova istanza della classe GlyphRunDrawing specificando il pennello in primo piano e GlyphRun.

Campi

ForegroundBrushProperty

Identifica la proprietà di dipendenza ForegroundBrush.

GlyphRunProperty

Identifica la proprietà di dipendenza GlyphRun.

Proprietà

Bounds

Ottiene i limiti allineati all'asse del contenuto del disegno.

(Ereditato da Drawing)
CanFreeze

Ottiene un valore che indica se l'oggetto può essere reso non modificabile.

(Ereditato da Freezable)
DependencyObjectType

Ottiene il DependencyObjectType che esegue il wrapping del tipo CLR di questa istanza.

(Ereditato da DependencyObject)
Dispatcher

Ottiene il Dispatcher a cui è associato questo DispatcherObject.

(Ereditato da DispatcherObject)
ForegroundBrush

Ottiene o imposta il pennello in primo piano del GlyphRunDrawing.

GlyphRun

Ottiene o imposta il GlyphRun che descrive il testo da disegnare.

HasAnimatedProperties

Ottiene un valore che indica se uno o più oggetti AnimationClock sono associati a una delle proprietà di dipendenza di questo oggetto.

(Ereditato da Animatable)
IsFrozen

Ottiene un valore che indica se l'oggetto è attualmente modificabile.

(Ereditato da Freezable)
IsSealed

Ottiene un valore che indica se questa istanza è attualmente sealed (sola lettura).

(Ereditato da DependencyObject)

Metodi

ApplyAnimationClock(DependencyProperty, AnimationClock)

Applica un AnimationClock all'DependencyPropertyspecificato. Se la proprietà è già animata, viene utilizzato il comportamento di handoff SnapshotAndReplace.

(Ereditato da Animatable)
ApplyAnimationClock(DependencyProperty, AnimationClock, HandoffBehavior)

Applica un AnimationClock all'DependencyPropertyspecificato. Se la proprietà è già animata, viene utilizzata la HandoffBehavior specificata.

(Ereditato da Animatable)
BeginAnimation(DependencyProperty, AnimationTimeline)

Applica un'animazione al DependencyPropertyspecificato. L'animazione viene avviata quando viene eseguito il rendering del fotogramma successivo. Se la proprietà specificata è già animata, viene utilizzato il comportamento di handoff SnapshotAndReplace.

(Ereditato da Animatable)
BeginAnimation(DependencyProperty, AnimationTimeline, HandoffBehavior)

Applica un'animazione al DependencyPropertyspecificato. L'animazione viene avviata quando viene eseguito il rendering del fotogramma successivo. Se la proprietà specificata è già animata, viene utilizzata la HandoffBehavior specificata.

(Ereditato da Animatable)
CheckAccess()

Determina se il thread chiamante ha accesso a questo DispatcherObject.

(Ereditato da DispatcherObject)
ClearValue(DependencyProperty)

Cancella il valore locale di una proprietà. La proprietà da cancellare viene specificata da un identificatore di DependencyProperty.

(Ereditato da DependencyObject)
ClearValue(DependencyPropertyKey)

Cancella il valore locale di una proprietà di sola lettura. La proprietà da cancellare viene specificata da un DependencyPropertyKey.

(Ereditato da DependencyObject)
Clone()

Crea un clone modificabile di questo GlyphRunDrawing, eseguendo copie complete dei valori di questo oggetto. Quando si copiano le proprietà di dipendenza, questo metodo copia i riferimenti alle risorse e i data binding (ma potrebbero non essere più risolti), ma non le animazioni o i relativi valori correnti.

CloneCore(Freezable)

Rende l'istanza un clone (copia completa) del Freezable specificato usando valori di proprietà di base (non animati).

(Ereditato da Freezable)
CloneCurrentValue()

Crea un clone modificabile di questo oggetto GlyphRunDrawing, eseguendo copie complete dei valori correnti dell'oggetto. I riferimenti alle risorse, i data binding e le animazioni non vengono copiati, ma i relativi valori correnti sono.

CloneCurrentValueCore(Freezable)

Rende l'istanza un clone modificabile (copia completa) del Freezable specificato utilizzando i valori correnti delle proprietà.

(Ereditato da Freezable)
CoerceValue(DependencyProperty)

Forza il valore della proprietà di dipendenza specificata. Questa operazione viene eseguita richiamando qualsiasi funzione CoerceValueCallback specificata nei metadati delle proprietà per la proprietà di dipendenza così come esiste nella chiamata DependencyObject.

(Ereditato da DependencyObject)
CreateInstance()

Inizializza una nuova istanza della classe Freezable.

(Ereditato da Freezable)
CreateInstanceCore()

Se implementato in una classe derivata, crea una nuova istanza della classe derivata Freezable.

(Ereditato da Freezable)
Equals(Object)

Determina se un DependencyObject specificato è equivalente all'DependencyObjectcorrente.

(Ereditato da DependencyObject)
Freeze()

Rende l'oggetto corrente non modificabile e imposta la relativa proprietà IsFrozen su true.

(Ereditato da Freezable)
FreezeCore(Boolean)

Rende questo Animatable oggetto non modificabile o determina se può essere reso non modificabile.

(Ereditato da Animatable)
GetAnimationBaseValue(DependencyProperty)

Restituisce il valore non animato del DependencyPropertyspecificato.

(Ereditato da Animatable)
GetAsFrozen()

Crea una copia bloccata del Freezable, utilizzando valori di proprietà di base (non animati). Poiché la copia è bloccata, tutti gli oggetti secondari bloccati vengono copiati in base al riferimento.

(Ereditato da Freezable)
GetAsFrozenCore(Freezable)

Rende l'istanza un clone bloccato del Freezable specificato utilizzando valori di proprietà di base (non animati).

(Ereditato da Freezable)
GetCurrentValueAsFrozen()

Crea una copia bloccata del Freezable utilizzando i valori correnti delle proprietà. Poiché la copia è bloccata, tutti gli oggetti secondari bloccati vengono copiati in base al riferimento.

(Ereditato da Freezable)
GetCurrentValueAsFrozenCore(Freezable)

Rende l'istanza corrente un clone bloccato del Freezablespecificato. Se l'oggetto ha proprietà di dipendenza animate, i valori animati correnti vengono copiati.

(Ereditato da Freezable)
GetHashCode()

Ottiene un codice hash per questo DependencyObject.

(Ereditato da DependencyObject)
GetLocalValueEnumerator()

Crea un enumeratore specializzato per determinare quali proprietà di dipendenza hanno valori impostati localmente in questo DependencyObject.

(Ereditato da DependencyObject)
GetType()

Ottiene il Type dell'istanza corrente.

(Ereditato da Object)
GetValue(DependencyProperty)

Restituisce il valore effettivo corrente di una proprietà di dipendenza in questa istanza di un DependencyObject.

(Ereditato da DependencyObject)
InvalidateProperty(DependencyProperty)

Rivaluta il valore effettivo per la proprietà di dipendenza specificata.

(Ereditato da DependencyObject)
MemberwiseClone()

Crea una copia superficiale del Objectcorrente.

(Ereditato da Object)
OnChanged()

Chiamato quando viene modificato l'oggetto Freezable corrente.

(Ereditato da Freezable)
OnFreezablePropertyChanged(DependencyObject, DependencyObject)

Assicura che vengano stabiliti puntatori di contesto appropriati per un membro dati DependencyObjectType appena impostato.

(Ereditato da Freezable)
OnFreezablePropertyChanged(DependencyObject, DependencyObject, DependencyProperty)

Questo membro supporta l'infrastruttura di Windows Presentation Foundation (WPF) e non deve essere usato direttamente dal codice.

(Ereditato da Freezable)
OnPropertyChanged(DependencyPropertyChangedEventArgs)

Esegue l'override dell'implementazione DependencyObject di OnPropertyChanged(DependencyPropertyChangedEventArgs) per richiamare anche eventuali gestori di Changed in risposta a una proprietà di dipendenza modificata di tipo Freezable.

(Ereditato da Freezable)
ReadLocalValue(DependencyProperty)

Restituisce il valore locale di una proprietà di dipendenza, se esistente.

(Ereditato da DependencyObject)
ReadPreamble()

Assicura che l'accesso al Freezable venga eseguito da un thread valido. Gli eredi di Freezable devono chiamare questo metodo all'inizio di qualsiasi API che legge i membri dati che non sono proprietà di dipendenza.

(Ereditato da Freezable)
SetCurrentValue(DependencyProperty, Object)

Imposta il valore di una proprietà di dipendenza senza modificarne l'origine del valore.

(Ereditato da DependencyObject)
SetValue(DependencyProperty, Object)

Imposta il valore locale di una proprietà di dipendenza, specificato dall'identificatore della proprietà di dipendenza.

(Ereditato da DependencyObject)
SetValue(DependencyPropertyKey, Object)

Imposta il valore locale di una proprietà di dipendenza di sola lettura, specificato dall'identificatore DependencyPropertyKey della proprietà di dipendenza.

(Ereditato da DependencyObject)
ShouldSerializeProperty(DependencyProperty)

Restituisce un valore che indica se i processi di serializzazione devono serializzare il valore per la proprietà di dipendenza specificata.

(Ereditato da DependencyObject)
ToString()

Restituisce una stringa che rappresenta l'oggetto corrente.

(Ereditato da Object)
VerifyAccess()

Impone che il thread chiamante abbia accesso a questo DispatcherObject.

(Ereditato da DispatcherObject)
WritePostscript()

Genera l'evento Changed per il Freezable e richiama il relativo metodo OnChanged(). Le classi che derivano da Freezable devono chiamare questo metodo alla fine di qualsiasi API che modifica i membri della classe non archiviati come proprietà di dipendenza.

(Ereditato da Freezable)
WritePreamble()

Verifica che il Freezable non sia bloccato e che sia accessibile da un contesto di threading valido. Freezable eredi devono chiamare questo metodo all'inizio di qualsiasi API che scrive nei membri dati che non sono proprietà di dipendenza.

(Ereditato da Freezable)

Eventi

Changed

Si verifica quando la Freezable o un oggetto che contiene viene modificata.

(Ereditato da Freezable)

Si applica a