GlyphRunDrawing Clase

Definición

Representa un objeto Drawing que representa 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
Herencia

Ejemplos

En el ejemplo siguiente se usa un GlyphRunDrawing para dibujar el texto "Hola mundo".

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 es un objeto de bajo nivel diseñado para su uso con escenarios de impresión y presentación de documentos de formato fijo. Una manera más sencilla de dibujar texto en la pantalla es usar un Label o un TextBlock. Para obtener más información sobre GlyphRun, vea la introducción al objeto GlyphRun y el elemento Glyphs información general.

Comentarios

El objeto GlyphRun representa una secuencia de glifos de una sola cara de una sola fuente a un solo tamaño y con un estilo de representación único.

GlyphRun contiene detalles de fuente, como índices de glifo y posiciones de glifo individuales. Además, GlyphRun contiene los puntos de código Unicode originales a los que se generó la ejecución, la información de asignación de desplazamiento del búfer de caracteres al glifo y por carácter y por glifo.

Cada glifo de un GlyphRun define las métricas que especifican cómo se alinea con otros Glyphs. En el gráfico siguiente se definen las distintas calidades tipográficas de dos caracteres de glifo diferentes.

Diagraph of glyph measurements
Varias cualidades tipográficas de dos caracteres de glifo diferentes

características freezables: un GlyphRunDrawing es un tipo de objeto Freezable y, por tanto, se puede inmovilizar para mejorar el rendimiento. Para obtener información sobre las características de Freezable, como la congelación y la clonación, consulte la Información general sobre objetos freezable.

precaución:GlyphRunDrawing objetos no admiten la ejecución parcial de confianza. Una aplicación debe tener permisos de plena confianza para usar objetos GlyphRunDrawing.

Constructores

GlyphRunDrawing()

Inicializa una nueva instancia de la clase GlyphRunDrawing.

GlyphRunDrawing(Brush, GlyphRun)

Inicializa una nueva instancia de la clase GlyphRunDrawing especificando el pincel de primer plano y GlyphRun.

Campos

ForegroundBrushProperty

Identifica la propiedad de dependencia ForegroundBrush.

GlyphRunProperty

Identifica la propiedad de dependencia GlyphRun.

Propiedades

Bounds

Obtiene los límites alineados con el eje del contenido del dibujo.

(Heredado de Drawing)
CanFreeze

Obtiene un valor que indica si el objeto se puede hacer no modificable.

(Heredado de Freezable)
DependencyObjectType

Obtiene el DependencyObjectType que encapsula el tipo CLR de esta instancia.

(Heredado de DependencyObject)
Dispatcher

Obtiene el Dispatcher al que está asociado este DispatcherObject.

(Heredado de DispatcherObject)
ForegroundBrush

Obtiene o establece el pincel de primer plano de la GlyphRunDrawing.

GlyphRun

Obtiene o establece el GlyphRun que describe el texto que se va a dibujar.

HasAnimatedProperties

Obtiene un valor que indica si uno o varios objetos AnimationClock están asociados a cualquiera de las propiedades de dependencia de este objeto.

(Heredado de Animatable)
IsFrozen

Obtiene un valor que indica si el objeto se puede modificar actualmente.

(Heredado de Freezable)
IsSealed

Obtiene un valor que indica si esta instancia está actualmente sellada (solo lectura).

(Heredado de DependencyObject)

Métodos

ApplyAnimationClock(DependencyProperty, AnimationClock)

Aplica un AnimationClock al DependencyPropertyespecificado. Si la propiedad ya está animada, se usa el comportamiento de entrega SnapshotAndReplace.

(Heredado de Animatable)
ApplyAnimationClock(DependencyProperty, AnimationClock, HandoffBehavior)

Aplica un AnimationClock al DependencyPropertyespecificado. Si la propiedad ya está animada, se usa el HandoffBehavior especificado.

(Heredado de Animatable)
BeginAnimation(DependencyProperty, AnimationTimeline)

Aplica una animación al DependencyPropertyespecificado. La animación se inicia cuando se representa el siguiente fotograma. Si la propiedad especificada ya está animada, se usa el SnapshotAndReplace comportamiento de entrega.

(Heredado de Animatable)
BeginAnimation(DependencyProperty, AnimationTimeline, HandoffBehavior)

Aplica una animación al DependencyPropertyespecificado. La animación se inicia cuando se representa el siguiente fotograma. Si la propiedad especificada ya está animada, se usa el HandoffBehavior especificado.

(Heredado de Animatable)
CheckAccess()

Determina si el subproceso que llama tiene acceso a este DispatcherObject.

(Heredado de DispatcherObject)
ClearValue(DependencyProperty)

Borra el valor local de una propiedad. El identificador de DependencyProperty especifica la propiedad que se va a borrar.

(Heredado de DependencyObject)
ClearValue(DependencyPropertyKey)

Borra el valor local de una propiedad de solo lectura. Un DependencyPropertyKeyespecifica la propiedad que se va a borrar.

(Heredado de DependencyObject)
Clone()

Crea un clon modificable de este GlyphRunDrawing, realizando copias profundas de los valores de este objeto. Al copiar propiedades de dependencia, este método copia las referencias de recursos y los enlaces de datos (pero es posible que ya no se resuelvan), pero no animaciones ni sus valores actuales.

CloneCore(Freezable)

Convierte la instancia en un clon (copia profunda) del Freezable especificado mediante valores de propiedad base (no animados).

(Heredado de Freezable)
CloneCurrentValue()

Crea un clon modificable de este objeto GlyphRunDrawing, haciendo copias profundas de los valores actuales de este objeto. Las referencias de recursos, los enlaces de datos y las animaciones no se copian, pero sus valores actuales son.

CloneCurrentValueCore(Freezable)

Convierte la instancia en un clon modificable (copia profunda) del Freezable especificado mediante los valores de propiedad actuales.

(Heredado de Freezable)
CoerceValue(DependencyProperty)

Coerce el valor de la propiedad de dependencia especificada. Esto se logra invocando cualquier función de CoerceValueCallback especificada en metadatos de propiedad para la propiedad de dependencia tal como existe en la llamada a DependencyObject.

(Heredado de DependencyObject)
CreateInstance()

Inicializa una nueva instancia de la clase Freezable.

(Heredado de Freezable)
CreateInstanceCore()

Cuando se implementa en una clase derivada, crea una nueva instancia de la clase derivada Freezable.

(Heredado de Freezable)
Equals(Object)

Determina si un DependencyObject proporcionado es equivalente al DependencyObjectactual.

(Heredado de DependencyObject)
Freeze()

Hace que el objeto actual no se pueda modificar y establezca su propiedad IsFrozen en true.

(Heredado de Freezable)
FreezeCore(Boolean)

Hace que este objeto Animatable no se pueda modificar o determina si se puede hacer no modificable.

(Heredado de Animatable)
GetAnimationBaseValue(DependencyProperty)

Devuelve el valor no animado del DependencyPropertyespecificado.

(Heredado de Animatable)
GetAsFrozen()

Crea una copia inmovilizada de la Freezable, utilizando valores de propiedad base (no animados). Dado que la copia está inmovilizada, los sub-objetos congelados se copian por referencia.

(Heredado de Freezable)
GetAsFrozenCore(Freezable)

Convierte la instancia en un clon inmovilizado del Freezable especificado mediante valores de propiedad base (no animados).

(Heredado de Freezable)
GetCurrentValueAsFrozen()

Crea una copia inmovilizada del Freezable mediante los valores de propiedad actuales. Dado que la copia está inmovilizada, los sub-objetos congelados se copian por referencia.

(Heredado de Freezable)
GetCurrentValueAsFrozenCore(Freezable)

Convierte la instancia actual en un clon inmovilizado del Freezableespecificado. Si el objeto tiene propiedades de dependencia animadas, se copian sus valores animados actuales.

(Heredado de Freezable)
GetHashCode()

Obtiene un código hash para este DependencyObject.

(Heredado de DependencyObject)
GetLocalValueEnumerator()

Crea un enumerador especializado para determinar qué propiedades de dependencia tienen valores establecidos localmente en este DependencyObject.

(Heredado de DependencyObject)
GetType()

Obtiene el Type de la instancia actual.

(Heredado de Object)
GetValue(DependencyProperty)

Devuelve el valor efectivo actual de una propiedad de dependencia en esta instancia de un DependencyObject.

(Heredado de DependencyObject)
InvalidateProperty(DependencyProperty)

Vuelve a evaluar el valor efectivo de la propiedad de dependencia especificada.

(Heredado de DependencyObject)
MemberwiseClone()

Crea una copia superficial del Objectactual.

(Heredado de Object)
OnChanged()

Se llama cuando se modifica el objeto Freezable actual.

(Heredado de Freezable)
OnFreezablePropertyChanged(DependencyObject, DependencyObject)

Garantiza que los punteros de contexto adecuados se establecen para un miembro de datos de DependencyObjectType que se acaba de establecer.

(Heredado de Freezable)
OnFreezablePropertyChanged(DependencyObject, DependencyObject, DependencyProperty)

Este miembro admite la infraestructura de Windows Presentation Foundation (WPF) y no está pensada para usarse directamente desde el código.

(Heredado de Freezable)
OnPropertyChanged(DependencyPropertyChangedEventArgs)

Invalida la implementación de DependencyObject de OnPropertyChanged(DependencyPropertyChangedEventArgs) para invocar también los controladores de Changed en respuesta a una propiedad de dependencia cambiante de tipo Freezable.

(Heredado de Freezable)
ReadLocalValue(DependencyProperty)

Devuelve el valor local de una propiedad de dependencia, si existe.

(Heredado de DependencyObject)
ReadPreamble()

Garantiza que se accede a la Freezable desde un subproceso válido. Los heredadores de Freezable deben llamar a este método al principio de cualquier API que lea miembros de datos que no sean propiedades de dependencia.

(Heredado de Freezable)
SetCurrentValue(DependencyProperty, Object)

Establece el valor de una propiedad de dependencia sin cambiar su origen de valor.

(Heredado de DependencyObject)
SetValue(DependencyProperty, Object)

Establece el valor local de una propiedad de dependencia, especificado por su identificador de propiedad de dependencia.

(Heredado de DependencyObject)
SetValue(DependencyPropertyKey, Object)

Establece el valor local de una propiedad de dependencia de solo lectura, especificada por el identificador DependencyPropertyKey de la propiedad de dependencia.

(Heredado de DependencyObject)
ShouldSerializeProperty(DependencyProperty)

Devuelve un valor que indica si los procesos de serialización deben serializar el valor de la propiedad de dependencia proporcionada.

(Heredado de DependencyObject)
ToString()

Devuelve una cadena que representa el objeto actual.

(Heredado de Object)
VerifyAccess()

Exige que el subproceso de llamada tenga acceso a este DispatcherObject.

(Heredado de DispatcherObject)
WritePostscript()

Genera el evento Changed para el Freezable e invoca su método OnChanged(). Las clases que derivan de Freezable deben llamar a este método al final de cualquier API que modifique los miembros de clase que no se almacenan como propiedades de dependencia.

(Heredado de Freezable)
WritePreamble()

Comprueba que el Freezable no está inmovilizado y que se accede a él desde un contexto de subproceso válido. Freezable heredar deben llamar a este método al principio de cualquier API que escriba en miembros de datos que no sean propiedades de dependencia.

(Heredado de Freezable)

Eventos

Changed

Se produce cuando se modifica el Freezable o un objeto que contiene.

(Heredado de Freezable)

Se aplica a