DrawingGroup Classe

Definição

Representa uma coleção de desenhos que pode ser operada como um único desenho.Represents a collection of drawings that can be operated upon as a single drawing.

public ref class DrawingGroup sealed : System::Windows::Media::Drawing
[System.Windows.Markup.ContentProperty("Children")]
public sealed class DrawingGroup : System.Windows.Media.Drawing
type DrawingGroup = class
    inherit Drawing
Public NotInheritable Class DrawingGroup
Inherits Drawing
Herança
Atributos

Comentários

Use uma DrawingGroup para combinar vários desenhos em um único desenho composto.Use a DrawingGroup to combine multiple drawings into a single, composite drawing. Ao contrário de outros objetos Drawing, você pode aplicar uma Transform, BitmapEffect, Opacity configuração, OpacityMask, ClipGeometryou uma GuidelineSet a uma DrawingGroup.Unlike other Drawing objects, you can apply a Transform, BitmapEffect, Opacity setting, OpacityMask, ClipGeometry, or a GuidelineSet to a DrawingGroup. A flexibilidade dessa classe permite que você crie cenas complexas.The flexibility of this class enables you to create complex scenes.

Como DrawingGroup também é um Drawing, ele pode conter outros objetos DrawingGroup.Because DrawingGroup is also a Drawing, it can contain other DrawingGroup objects.

Para obter mais informações sobre objetos Drawing, consulte visão geral de objetos de desenho.For more information about Drawing objects, see Drawing Objects Overview.

Recursos de Freezable: Como ele é herdado da classe Freezable, a classe DrawingGroup fornece vários recursos especiais: DrawingGroup objetos podem ser declarados como, compartilhados entre vários objetos, tornados somente leitura para melhorar o desempenho, clonado e tornar-se seguro ao thread.Freezable Features: Because it inherits from the Freezable class, the DrawingGroup class provides several special features: DrawingGroup objects can be declared as , shared among multiple objects, made read-only to improve performance, cloned, and made thread-safe. Para obter mais informações sobre os diferentes recursos fornecidos pelos objetos Freezable, consulte visão geral dos objetos Freezable.For more information about the different features provided by Freezable objects, see Freezable Objects Overview.

Construtores

DrawingGroup()

Inicializa uma nova instância da classe DrawingGroup.Initializes a new instance of the DrawingGroup class.

Campos

BitmapEffectInputProperty

Identifica a propriedade de dependência BitmapEffectInput.Identifies the BitmapEffectInput dependency property.

BitmapEffectProperty

Identifica a propriedade de dependência BitmapEffect.Identifies the BitmapEffect dependency property.

ChildrenProperty

Identifica a propriedade de dependência Children.Identifies the Children dependency property.

ClipGeometryProperty

Identifica a propriedade de dependência ClipGeometry.Identifies the ClipGeometry dependency property.

GuidelineSetProperty

Identifica a propriedade de dependência GuidelineSet.Identifies the GuidelineSet dependency property.

OpacityMaskProperty

Identifica a propriedade de dependência OpacityMask.Identifies the OpacityMask dependency property.

OpacityProperty

Identifica a propriedade de dependência Opacity.Identifies the Opacity dependency property.

TransformProperty

Identifica a propriedade de dependência Transform.Identifies the Transform dependency property.

Propriedades

BitmapEffect

Obtém ou define o BitmapEffect a ser aplicado a este DrawingGroup.Gets or sets the BitmapEffect to apply to this DrawingGroup.

BitmapEffectInput

Obtém ou define a região em que o DrawingGroup aplica seu BitmapEffect e, opcionalmente, um BitmapSource para usar como entrada para seu BitmapEffect.Gets or sets the region where the DrawingGroup applies its BitmapEffect and, optionally, a BitmapSource to use as input for its BitmapEffect.

Bounds

Obtém os limites alinhados por eixo do conteúdo do desenho.Gets the axis-aligned bounds of the drawing's contents.

(Herdado de Drawing)
CanFreeze

Obtém um valor que indica se o objeto pode se tornar não modificável.Gets a value that indicates whether the object can be made unmodifiable.

(Herdado de Freezable)
Children

Obtém ou define os objetos Drawing contidos neste DrawingGroup.Gets or sets the Drawing objects that are contained in this DrawingGroup.

ClipGeometry

Obtém ou define a região de corte desse DrawingGroup.Gets or sets the clip region of this DrawingGroup.

DependencyObjectType

Obtém o DependencyObjectType que encapsula o tipo CLRCLR dessa instância.Gets the DependencyObjectType that wraps the CLRCLR type of this instance.

(Herdado de DependencyObject)
Dispatcher

Obtém o Dispatcher ao qual este DispatcherObject está associado.Gets the Dispatcher this DispatcherObject is associated with.

(Herdado de DispatcherObject)
GuidelineSet

Obtém ou define o GuidelineSet a ser aplicado a este DrawingGroup.Gets or sets the GuidelineSet to apply to this DrawingGroup.

HasAnimatedProperties

Obtém um valor que indica se um ou mais objetos AnimationClock está associado a qualquer uma das propriedades de dependência do objeto.Gets a value that indicates whether one or more AnimationClock objects is associated with any of this object's dependency properties.

(Herdado de Animatable)
IsFrozen

Obtém um valor que indica se o objeto pode ser modificado no momento.Gets a value that indicates whether the object is currently modifiable.

(Herdado de Freezable)
IsSealed

Obtém um valor que indica se essa instância está validada no momento (somente leitura).Gets a value that indicates whether this instance is currently sealed (read-only).

(Herdado de DependencyObject)
Opacity

Obtém ou define a opacidade deste DrawingGroup.Gets or sets the opacity of this DrawingGroup.

OpacityMask

Obtém ou define o pincel usado para alterar a opacidade de regiões selecionados deste DrawingGroup.Gets or sets the brush used to alter the opacity of select regions of this DrawingGroup.

Transform

Obtém ou define o Transform aplicado a este DrawingGroup.Gets or sets the Transform that is applied to this DrawingGroup.

Métodos

Append()

Abre o DrawingGroup para popular seu Children.Opens the DrawingGroup in order to populate its Children. Esse método permite que você acrescente Children adicionais a este DrawingGroup.This method enables you to append additional Children to this DrawingGroup.

ApplyAnimationClock(DependencyProperty, AnimationClock)

Aplica um AnimationClock ao DependencyProperty especificado.Applies an AnimationClock to the specified DependencyProperty. Se a propriedade já tiver sido animada, o comportamento de entrega de SnapshotAndReplace será usado.If the property is already animated, the SnapshotAndReplace handoff behavior is used.

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

Aplica um AnimationClock ao DependencyProperty especificado.Applies an AnimationClock to the specified DependencyProperty. Se a propriedade já for animada, o HandoffBehavior especificado será usado.If the property is already animated, the specified HandoffBehavior is used.

(Herdado de Animatable)
BeginAnimation(DependencyProperty, AnimationTimeline)

Aplica uma animação ao DependencyProperty especificado.Applies an animation to the specified DependencyProperty. A animação é iniciada quando o próximo quadro for renderizado.The animation is started when the next frame is rendered. Se a propriedade especificada já tiver sido animada, o comportamento de entrega de SnapshotAndReplace será usado.If the specified property is already animated, the SnapshotAndReplace handoff behavior is used.

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

Aplica uma animação ao DependencyProperty especificado.Applies an animation to the specified DependencyProperty. A animação é iniciada quando o próximo quadro for renderizado.The animation is started when the next frame is rendered. Se a propriedade especifica já for animada, o HandoffBehavior especificado será usado.If the specified property is already animated, the specified HandoffBehavior is used.

(Herdado de Animatable)
CheckAccess()

Determina se o thread de chamada tem acesso a este DispatcherObject.Determines whether the calling thread has access to this DispatcherObject.

(Herdado de DispatcherObject)
ClearValue(DependencyProperty)

Limpa o valor local de uma propriedade.Clears the local value of a property. A propriedade a ser limpa é especificada por um identificador DependencyProperty.The property to be cleared is specified by a DependencyProperty identifier.

(Herdado de DependencyObject)
ClearValue(DependencyPropertyKey)

Limpa o valor local de uma propriedade somente leitura.Clears the local value of a read-only property. A propriedade a ser limpa é especificada por um DependencyPropertyKey.The property to be cleared is specified by a DependencyPropertyKey.

(Herdado de DependencyObject)
Clone()

Cria uma cópia profunda modificável deste DrawingGroup e faz cópias profundas de seus valores.Creates a modifiable deep copy of this DrawingGroup and makes deep copies of its values.

CloneCore(Freezable)

Faz com que a instância seja um clone (cópia em profundidade) do Freezable especificado usando valores de propriedade base (não animados).Makes the instance a clone (deep copy) of the specified Freezable using base (non-animated) property values.

(Herdado de Freezable)
CloneCurrentValue()

Cria uma cópia profunda modificável deste objeto DrawingGroup e faz cópias profundas de seus valores atuais.Creates a modifiable deep copy of this DrawingGroup object and makes deep copies of its current values.

CloneCurrentValueCore(Freezable)

Torna a instância um clone modificável (cópia em profundidade) do Freezable especificado usando os valores de propriedade atuais.Makes the instance a modifiable clone (deep copy) of the specified Freezable using current property values.

(Herdado de Freezable)
CoerceValue(DependencyProperty)

Converte o valor da propriedade de dependência especificada.Coerces the value of the specified dependency property. Isso é feito invocando qualquer função CoerceValueCallback especificada nos metadados de propriedade para a propriedade de dependência, visto que ela existe na chamada a DependencyObject.This is accomplished by invoking any CoerceValueCallback function specified in property metadata for the dependency property as it exists on the calling DependencyObject.

(Herdado de DependencyObject)
CreateInstance()

Inicializa uma nova instância da classe Freezable.Initializes a new instance of the Freezable class.

(Herdado de Freezable)
CreateInstanceCore()

Quando implementado em uma classe derivada, cria uma nova instância da classe derivada Freezable.When implemented in a derived class, creates a new instance of the Freezable derived class.

(Herdado de Freezable)
Equals(Object)

Determina se um DependencyObject fornecido é equivalente ao DependencyObject atual.Determines whether a provided DependencyObject is equivalent to the current DependencyObject.

(Herdado de DependencyObject)
Freeze()

Torna o objeto atual não modificável e define sua propriedade IsFrozen para true.Makes the current object unmodifiable and sets its IsFrozen property to true.

(Herdado de Freezable)
FreezeCore(Boolean)

Faz com que este objeto Animatable não seja modificável ou determina se ele pode se tornar não modificável.Makes this Animatable object unmodifiable or determines whether it can be made unmodifiable.

(Herdado de Animatable)
GetAnimationBaseValue(DependencyProperty)

Retorna o valor não animado do DependencyProperty especificado.Returns the non-animated value of the specified DependencyProperty.

(Herdado de Animatable)
GetAsFrozen()

Cria uma cópia congelada o Freezable usando valores de propriedade base (não animadas).Creates a frozen copy of the Freezable, using base (non-animated) property values. Já que a cópia está congelada, quaisquer subobjetos congelados são copiados por referência.Because the copy is frozen, any frozen sub-objects are copied by reference.

(Herdado de Freezable)
GetAsFrozenCore(Freezable)

Torna a instância um clone congelado do Freezable especificado usando valores de propriedade base (não animados).Makes the instance a frozen clone of the specified Freezable using base (non-animated) property values.

(Herdado de Freezable)
GetCurrentValueAsFrozen()

Cria uma cópia congelada do Freezable usando valores de propriedade atuais.Creates a frozen copy of the Freezable using current property values. Já que a cópia está congelada, quaisquer subobjetos congelados são copiados por referência.Because the copy is frozen, any frozen sub-objects are copied by reference.

(Herdado de Freezable)
GetCurrentValueAsFrozenCore(Freezable)

Torna a instância atual um clone congelado do Freezable especificado.Makes the current instance a frozen clone of the specified Freezable. Se o objeto tiver propriedades de dependência animadas, seus valores animados atuais serão copiados.If the object has animated dependency properties, their current animated values are copied.

(Herdado de Freezable)
GetHashCode()

Obtém o código hash para esse DependencyObject.Gets a hash code for this DependencyObject.

(Herdado de DependencyObject)
GetLocalValueEnumerator()

Cria um enumerador especializado para determinar quais propriedades de dependência têm valores definidos localmente nessa DependencyObject.Creates a specialized enumerator for determining which dependency properties have locally set values on this DependencyObject.

(Herdado de DependencyObject)
GetType()

Obtém o Type da instância atual.Gets the Type of the current instance.

(Herdado de Object)
GetValue(DependencyProperty)

Retorna o valor efetivo atual de uma propriedade de dependência nessa instância de um DependencyObject.Returns the current effective value of a dependency property on this instance of a DependencyObject.

(Herdado de DependencyObject)
InvalidateProperty(DependencyProperty)

Reavalia o valor efetivo para a propriedade de dependência especificada.Re-evaluates the effective value for the specified dependency property.

(Herdado de DependencyObject)
MemberwiseClone()

Cria uma cópia superficial do Object atual.Creates a shallow copy of the current Object.

(Herdado de Object)
OnChanged()

Chamado quando o objeto Freezable atual é modificado.Called when the current Freezable object is modified.

(Herdado de Freezable)
OnFreezablePropertyChanged(DependencyObject, DependencyObject)

Garante que os ponteiros de contexto apropriados sejam estabelecidos para um membro de dados DependencyObjectType que foi recém-definido.Ensures that appropriate context pointers are established for a DependencyObjectType data member that has just been set.

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

Este membro dá suporte à infraestrutura Windows Presentation Foundation (WPF)Windows Presentation Foundation (WPF) e não se destina a ser usado diretamente do código.This member supports the Windows Presentation Foundation (WPF)Windows Presentation Foundation (WPF) infrastructure and is not intended to be used directly from your code.

(Herdado de Freezable)
OnPropertyChanged(DependencyPropertyChangedEventArgs)

Substitui a implementação DependencyObject de OnPropertyChanged(DependencyPropertyChangedEventArgs) para também invocar quaisquer manipuladores Changed em resposta à alteração de uma propriedade de dependência do tipo Freezable.Overrides the DependencyObject implementation of OnPropertyChanged(DependencyPropertyChangedEventArgs) to also invoke any Changed handlers in response to a changing dependency property of type Freezable.

(Herdado de Freezable)
Open()

Abre o DrawingGroup para popular seu Children e limpa todos os Children existentes.Opens the DrawingGroup in order to populate its Children and clears any existing Children.

ReadLocalValue(DependencyProperty)

Retorna o valor local de uma propriedade de dependência, local, se houver.Returns the local value of a dependency property, if it exists.

(Herdado de DependencyObject)
ReadPreamble()

Garante que o Freezable esteja sendo acessado de um thread válido.Ensures that the Freezable is being accessed from a valid thread. Herdeiros do Freezable devem chamar esse método no início de qualquer API que lê membros de dados que não são propriedades de dependência.Inheritors of Freezable must call this method at the beginning of any API that reads data members that are not dependency properties.

(Herdado de Freezable)
SetCurrentValue(DependencyProperty, Object)

Define o valor da propriedade de dependência sem alterar a origem do valor.Sets the value of a dependency property without changing its value source.

(Herdado de DependencyObject)
SetValue(DependencyProperty, Object)

Define o valor local de uma propriedade de dependência, especificada pelo identificador da propriedade de dependência.Sets the local value of a dependency property, specified by its dependency property identifier.

(Herdado de DependencyObject)
SetValue(DependencyPropertyKey, Object)

Define o valor de uma propriedade de dependência somente leitura, especificada pelo identificador DependencyPropertyKey da propriedade de dependência.Sets the local value of a read-only dependency property, specified by the DependencyPropertyKey identifier of the dependency property.

(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.Returns a value that indicates whether serialization processes should serialize the value for the provided dependency property.

(Herdado de DependencyObject)
ToString()

Retorna uma cadeia de caracteres que representa o objeto atual.Returns a string that represents the current object.

(Herdado de Object)
VerifyAccess()

Impõe que o thread de chamada tenha acesso a este DispatcherObject.Enforces that the calling thread has access to this DispatcherObject.

(Herdado de DispatcherObject)
WritePostscript()

Aciona o evento Changed para o Freezable e invoca o respectivo método OnChanged().Raises the Changed event for the Freezable and invokes its OnChanged() method. Classes que derivam de Freezable devem chamar este método no final de qualquer API que modifica os membros de classe que não são armazenados como propriedades de dependência.Classes that derive from Freezable should call this method at the end of any API that modifies class members that are not stored as dependency properties.

(Herdado de Freezable)
WritePreamble()

Verifica se o Freezable não está congelado e está sendo acessado de um contexto de threading válido.Verifies that the Freezable is not frozen and that it is being accessed from a valid threading context. Herdeiros do Freezable 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.Freezable inheritors should call this method at the beginning of any API that writes to data members that are not dependency properties.

(Herdado de Freezable)

Eventos

Changed

Ocorre quando o Freezable ou um objeto nele contido é modificado.Occurs when the Freezable or an object it contains is modified.

(Herdado de Freezable)

Aplica-se a

Veja também