GlyphRunDrawing Classe

Definição

Representa um objeto Drawing que renderiza um 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
Herança

Exemplos

O exemplo a seguir usa um GlyphRunDrawing para desenhar o texto "Olá, 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>

Um GlyphRun é um objeto de baixo nível destinado a ser usado com cenários de impressão e apresentação de documento de formato fixo. Uma maneira mais simples de desenhar texto para a tela é usar um Label ou um TextBlock. Para obter mais informações sobre GlyphRun, consulte a introdução ao objeto GlyphRun e à visão geral do elemento glifos.

Comentários

O objeto GlyphRun representa uma sequência de glifos de uma única face de uma única fonte em um único tamanho e com um único estilo de renderização.

GlyphRun contém detalhes da fonte, como índices de glifo e posições de glifo individuais. Além disso, GlyphRun contém os pontos de código Unicode originais dos quais a execução foi gerada, as informações de mapeamento de deslocamento de buffer de caractere a glifo e por caractere e por glifo.

Cada glifo em um GlyphRun define métricas que especificam como ele se alinha com outras Glyphs. O gráfico a seguir define as várias qualidades tipográficas de dois caracteres de glifo diferentes.

Diagrafo de medidas de glifo
Várias qualidades tipográficas de dois caracteres de glifo diferentes

Recursos Do Freezable: um GlyphRunDrawing é um tipo de objeto Freezable e, portanto, pode ser congelado para melhorar o desempenho. Para obter informações sobre Freezable recursos, como congelamento e clonagem, consulte a visão geral dos objetos freezable.

Cuidado:GlyphRunDrawing objetos não dão suporte à execução parcial da confiança. Um aplicativo deve ter permissões de confiança total para usar objetos GlyphRunDrawing.

Construtores

GlyphRunDrawing()

Inicializa uma nova instância da classe GlyphRunDrawing.

GlyphRunDrawing(Brush, GlyphRun)

Inicializa uma nova instância da classe GlyphRunDrawing especificando o pincel de primeiro plano e GlyphRun.

Campos

ForegroundBrushProperty

Identifica a propriedade de dependência ForegroundBrush.

GlyphRunProperty

Identifica a propriedade de dependência GlyphRun.

Propriedades

Bounds

Obtém os limites alinhados ao eixo do conteúdo do desenho.

(Herdado de Drawing)
CanFreeze

Obtém um valor que indica se o objeto pode ser tornado inmodificável.

(Herdado de Freezable)
DependencyObjectType

Obtém o DependencyObjectType que encapsula o tipo CLR dessa instância.

(Herdado de DependencyObject)
Dispatcher

Obtém o Dispatcher ao qual esse DispatcherObject está associado.

(Herdado de DispatcherObject)
ForegroundBrush

Obtém ou define o pincel de primeiro plano do GlyphRunDrawing.

GlyphRun

Obtém ou define o GlyphRun que descreve o texto a ser desenhado.

HasAnimatedProperties

Obtém um valor que indica se um ou mais objetos AnimationClock estão associados a qualquer uma das propriedades de dependência desse objeto.

(Herdado de Animatable)
IsFrozen

Obtém um valor que indica se o objeto é modificável no momento.

(Herdado de Freezable)
IsSealed

Obtém um valor que indica se essa instância está lacrada no momento (somente leitura).

(Herdado de DependencyObject)

Métodos

ApplyAnimationClock(DependencyProperty, AnimationClock)

Aplica um AnimationClock ao DependencyPropertyespecificado. Se a propriedade já estiver animada, o comportamento de entrega SnapshotAndReplace será usado.

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

Aplica um AnimationClock ao DependencyPropertyespecificado. Se a propriedade já estiver animada, o HandoffBehavior especificado será usado.

(Herdado de Animatable)
BeginAnimation(DependencyProperty, AnimationTimeline)

Aplica uma animação ao DependencyPropertyespecificado. A animação é iniciada quando o próximo quadro é renderizado. Se a propriedade especificada já estiver animada, o comportamento de entrega SnapshotAndReplace será usado.

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

Aplica uma animação ao DependencyPropertyespecificado. A animação é iniciada quando o próximo quadro é renderizado. Se a propriedade especificada já estiver animada, o HandoffBehavior especificado será usado.

(Herdado de Animatable)
CheckAccess()

Determina se o thread de chamada tem acesso a esse DispatcherObject.

(Herdado de DispatcherObject)
ClearValue(DependencyProperty)

Limpa o valor local de uma propriedade. A propriedade a ser desmarcada é especificada por um identificador de DependencyProperty.

(Herdado de DependencyObject)
ClearValue(DependencyPropertyKey)

Limpa o valor local de uma propriedade somente leitura. A propriedade a ser desmarcada é especificada por um DependencyPropertyKey.

(Herdado de DependencyObject)
Clone()

Cria um clone modificável desse GlyphRunDrawing, fazendo cópias profundas dos valores desse objeto. Ao copiar propriedades de dependência, esse método copia referências de recurso e associações de dados (mas elas podem não resolver mais), mas não animações ou seus valores atuais.

CloneCore(Freezable)

Torna a instância um clone (cópia profunda) do Freezable especificado usando valores de propriedade base (não animados).

(Herdado de Freezable)
CloneCurrentValue()

Cria um clone modificável desse objeto GlyphRunDrawing, fazendo cópias profundas dos valores atuais desse objeto. Referências de recursos, associações de dados e animações não são copiadas, mas seus valores atuais são.

CloneCurrentValueCore(Freezable)

Torna a instância um clone modificável (cópia profunda) do Freezable especificado usando valores de propriedade atuais.

(Herdado de Freezable)
CoerceValue(DependencyProperty)

Coagi o valor da propriedade de dependência especificada. Isso é feito invocando qualquer função de CoerceValueCallback especificada em metadados de propriedade para a propriedade de dependência como ela existe na chamada DependencyObject.

(Herdado de DependencyObject)
CreateInstance()

Inicializa uma nova instância da classe Freezable.

(Herdado de Freezable)
CreateInstanceCore()

Quando implementado em uma classe derivada, cria uma nova instância da classe derivada Freezable.

(Herdado de Freezable)
Equals(Object)

Determina se um DependencyObject fornecido é equivalente ao DependencyObjectatual.

(Herdado de DependencyObject)
Freeze()

Torna o objeto atual inmodificável e define sua propriedade IsFrozen como true.

(Herdado de Freezable)
FreezeCore(Boolean)

Torna esse objeto Animatable inmodificável ou determina se ele pode se tornar inmodificável.

(Herdado de Animatable)
GetAnimationBaseValue(DependencyProperty)

Retorna o valor não animado do DependencyPropertyespecificado.

(Herdado de Animatable)
GetAsFrozen()

Cria uma cópia congelada do Freezable, usando valores de propriedade base (não animados). Como a cópia está congelada, todos os sub-objetos congelados são copiados por referência.

(Herdado de Freezable)
GetAsFrozenCore(Freezable)

Torna a instância um clone congelado do Freezable especificado usando valores de propriedade base (não animados).

(Herdado de Freezable)
GetCurrentValueAsFrozen()

Cria uma cópia congelada do Freezable usando valores de propriedade atuais. Como a cópia está congelada, todos os sub-objetos congelados são copiados por referência.

(Herdado de Freezable)
GetCurrentValueAsFrozenCore(Freezable)

Torna a instância atual um clone congelado do Freezableespecificado. Se o objeto tiver propriedades de dependência animadas, seus valores animados atuais serão copiados.

(Herdado de Freezable)
GetHashCode()

Obtém um código hash para este DependencyObject.

(Herdado de DependencyObject)
GetLocalValueEnumerator()

Cria um enumerador especializado para determinar quais propriedades de dependência têm valores definidos localmente neste DependencyObject.

(Herdado de DependencyObject)
GetType()

Obtém o Type da instância atual.

(Herdado de Object)
GetValue(DependencyProperty)

Retorna o valor efetivo atual de uma propriedade de dependência nesta instância de um DependencyObject.

(Herdado de DependencyObject)
InvalidateProperty(DependencyProperty)

Reavalia o valor efetivo da propriedade de dependência especificada.

(Herdado de DependencyObject)
MemberwiseClone()

Cria uma cópia superficial do Objectatual.

(Herdado de Object)
OnChanged()

Chamado quando o objeto Freezable atual é modificado.

(Herdado de Freezable)
OnFreezablePropertyChanged(DependencyObject, DependencyObject)

Garante que os ponteiros de contexto apropriados sejam estabelecidos para um membro de dados DependencyObjectType que acabou de ser definido.

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

Esse membro dá suporte à infraestrutura do WPF (Windows Presentation Foundation) e não se destina a ser usado diretamente do seu código.

(Herdado de Freezable)
OnPropertyChanged(DependencyPropertyChangedEventArgs)

Substitui a implementação DependencyObject de OnPropertyChanged(DependencyPropertyChangedEventArgs) para invocar também os manipuladores de Changed em resposta a uma propriedade de dependência variável do tipo Freezable.

(Herdado de Freezable)
ReadLocalValue(DependencyProperty)

Retorna o valor local de uma propriedade de dependência, se ela existir.

(Herdado de DependencyObject)
ReadPreamble()

Garante que o Freezable esteja sendo acessado de um thread válido. Os herdadores de Freezable devem chamar esse método no início de qualquer API que leia os membros de dados que não são propriedades de dependência.

(Herdado de Freezable)
SetCurrentValue(DependencyProperty, Object)

Define o valor de uma propriedade de dependência sem alterar sua fonte de valor.

(Herdado de DependencyObject)
SetValue(DependencyProperty, Object)

Define o valor local de uma propriedade de dependência, especificada por seu identificador de propriedade de dependência.

(Herdado de DependencyObject)
SetValue(DependencyPropertyKey, Object)

Define o valor local de uma propriedade de dependência somente leitura, especificada pelo identificador DependencyPropertyKey da propriedade de dependência.

(Herdado de DependencyObject)
ShouldSerializeProperty(DependencyProperty)

Retorna um valor que indica se os processos de serialização devem serializar o valor da propriedade de dependência fornecida.

(Herdado de DependencyObject)
ToString()

Retorna uma cadeia de caracteres que representa o objeto atual.

(Herdado de Object)
VerifyAccess()

Impõe que o thread de chamada tenha acesso a esse DispatcherObject.

(Herdado de DispatcherObject)
WritePostscript()

Gera o evento Changed para o Freezable e invoca seu método OnChanged(). Classes que derivam de Freezable devem chamar esse método no final de qualquer API que modifique os membros da classe que não são armazenados como propriedades de dependência.

(Herdado de Freezable)
WritePreamble()

Verifica se o Freezable não está congelado e se está sendo acessado de um contexto de threading válido. Freezable herdadores devem chamar esse método no início de qualquer API que grava em membros de dados que não são propriedades de dependência.

(Herdado de Freezable)

Eventos

Changed

Ocorre quando o Freezable ou um objeto que ele contém é modificado.

(Herdado de Freezable)

Aplica-se a