ContainerVisual Classe

Definição

Gerencia uma coleção de objetos Visual.Manages a collection of Visual objects.

public ref class ContainerVisual : System::Windows::Media::Visual
public class ContainerVisual : System.Windows.Media.Visual
type ContainerVisual = class
    inherit Visual
Public Class ContainerVisual
Inherits Visual
Herança
Derivado

Exemplos

O exemplo a seguir mostra como criar um objeto ContainerVisual que é usado como o pai para dois objetos DrawingVisual.The following example shows how to create a ContainerVisual object that is used as the parent for two DrawingVisual objects. Os objetos que são adicionados ao objeto de ContainerVisual devem ser adicionados em ordem z inversa (de baixo para cima) para garantir que eles estejam sendo renderizados na ordem de desenho correta.Objects that are added to the ContainerVisual object must be added in reverse z-order (bottom to top) to ensure they are rendering in the correct drawing order. Para que a árvore visual seja enumerada corretamente, o exemplo fornece implementações substituídas do método GetVisualChild e VisualChildrenCount propriedade.In order for the visual tree to be enumerated correctly, the example provides overridden implementations of the GetVisualChild method and VisualChildrenCount property.

// Create a host visual derived from the FrameworkElement class.
// This class provides layout, event handling, and container support for
// the child visual objects.
public class MyContainerVisualHost : FrameworkElement
{
    private ContainerVisual _containerVisual;

    public MyContainerVisualHost(DrawingVisual border, DrawingVisual text)
    {
        // Create a ContainerVisual to hold DrawingVisual children.
        _containerVisual = new ContainerVisual();

        // Add children to ContainerVisual in reverse z-order (bottom to top).
        _containerVisual.Children.Add(border);
        _containerVisual.Children.Add(text);

        // Create parent-child relationship with host visual and ContainerVisual.
        this.AddVisualChild(_containerVisual);
    }

    // Provide a required override for the VisualChildrenCount property.
    protected override int VisualChildrenCount
    {
        get { return _containerVisual == null ? 0 : 1; }
    }

    // Provide a required override for the GetVisualChild method.
    protected override Visual GetVisualChild(int index)
    {
        if (_containerVisual == null)
        {
            throw new ArgumentOutOfRangeException();
        }

        return _containerVisual;
    }
}
' Create a host visual derived from the FrameworkElement class.
' This class provides layout, event handling, and container support for
' the child visual objects.
Public Class MyContainerVisualHost
    Inherits FrameworkElement
    Private _containerVisual As ContainerVisual

    Public Sub New(ByVal border As DrawingVisual, ByVal text As DrawingVisual)
        ' Create a ContainerVisual to hold DrawingVisual children.
        _containerVisual = New ContainerVisual()

        ' Add children to ContainerVisual in reverse z-order (bottom to top).
        _containerVisual.Children.Add(border)
        _containerVisual.Children.Add(text)

        ' Create parent-child relationship with host visual and ContainerVisual.
        Me.AddVisualChild(_containerVisual)
    End Sub

    ' Provide a required override for the VisualChildrenCount property.
    Protected Overrides ReadOnly Property VisualChildrenCount() As Integer
        Get
            Return If(_containerVisual Is Nothing, 0, 1)
        End Get
    End Property

    ' Provide a required override for the GetVisualChild method.
    Protected Overrides Function GetVisualChild(ByVal index As Integer) As Visual
        If _containerVisual Is Nothing Then
            Throw New ArgumentOutOfRangeException()
        End If

        Return _containerVisual
    End Function
End Class

Comentários

A classe ContainerVisual é usada como um contêiner para uma coleção de objetos Visual.The ContainerVisual class is used as a container for a collection of Visual objects. A classe DrawingVisual deriva da classe ContainerVisual, de modo que a classe DrawingVisual também pode conter uma coleção de objetos visuais.The DrawingVisual class derives from the ContainerVisual class, such that the DrawingVisual class can also contain a collection of visual objects.

Construtores

ContainerVisual()

Cria uma nova instância da classe ContainerVisual.Creates a new instance of the ContainerVisual class.

Propriedades

BitmapEffect

Obtém ou define um valor BitmapEffect para o ContainerVisual.Gets or sets a BitmapEffect value for the ContainerVisual.

BitmapEffectInput

Obtém ou define um valor BitmapEffectInput para o ContainerVisual.Gets or sets a BitmapEffectInput value for the ContainerVisual.

CacheMode

Obtém ou define uma representação armazenada em cache do ContainerVisual.Gets or sets a cached representation of the ContainerVisual.

Children

Obtém a coleção filho do ContainerVisual.Gets the child collection of the ContainerVisual.

Clip

Obtém ou define a área de recorte do ContainerVisual.Gets or sets the clipping region of the ContainerVisual.

ContentBounds

Obtém a caixa delimitadora do conteúdo do ContainerVisual.Gets the bounding box for the contents of the ContainerVisual.

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)
DescendantBounds

Obtém a união de todas as caixas delimitadoras de conteúdo para todos os descendentes do ContainerVisual, mas não incluindo o conteúdo do ContainerVisual.Gets the union of all the content bounding boxes for all of the descendants of the ContainerVisual, but not including the contents of the ContainerVisual.

Dispatcher

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

(Herdado de DispatcherObject)
Effect

Obtém ou define o efeito de bitmap a ser aplicado ao ContainerVisual.Gets or sets the bitmap effect to apply to the ContainerVisual.

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)
Offset

Obtém ou define o valor de deslocamento do ContainerVisual do seu ponto de referência.Gets or sets the offset value of the ContainerVisual from its reference point.

Opacity

Obtém ou define a opacidade do ContainerVisual, com base em 0 = transparente, 1 = opaco.Gets or sets the opacity of the ContainerVisual, based on 0=transparent, 1=opaque.

OpacityMask

Obtém ou define um pincel que especifica uma máscara de opacidade possível para o ContainerVisual.Gets or sets a brush that specifies a possible opacity mask for the ContainerVisual.

Parent

Obtém o Visual pai para o ContainerVisual.Gets the parent Visual for the ContainerVisual.

Transform

Obtém ou define a transformação aplicada ao ContainerVisual.Gets or sets the transform that is applied to the ContainerVisual.

VisualBitmapEffect

Obtém ou define o valor BitmapEffect para o Visual.Gets or sets the BitmapEffect value for the Visual.

(Herdado de Visual)
VisualBitmapEffectInput

Obtém ou define o valor BitmapEffectInput para o Visual.Gets or sets the BitmapEffectInput value for the Visual.

(Herdado de Visual)
VisualBitmapScalingMode

Obtém ou define o BitmapScalingMode do Visual.Gets or sets the BitmapScalingMode for the Visual.

(Herdado de Visual)
VisualCacheMode

Obtém ou define uma representação armazenada em cache do Visual.Gets or sets a cached representation of the Visual.

(Herdado de Visual)
VisualChildrenCount

Obtém o número de filhos para o ContainerVisual.Gets the number of children for the ContainerVisual.

VisualClearTypeHint

Obtém ou define o ClearTypeHint que determina como o ClearType é renderizado no Visual.Gets or sets the ClearTypeHint that determines how ClearType is rendered in the Visual.

(Herdado de Visual)
VisualClip

Obtém ou define a região de corte do Visual como um valor Geometry.Gets or sets the clip region of the Visual as a Geometry value.

(Herdado de Visual)
VisualEdgeMode

Obtém ou define o modo de borda do Visual com um valor EdgeMode.Gets or sets the edge mode of the Visual as an EdgeMode value.

(Herdado de Visual)
VisualEffect

Obtém ou define o efeito de bitmap a ser aplicado ao Visual.Gets or sets the bitmap effect to apply to the Visual.

(Herdado de Visual)
VisualOffset

Obtém ou define o valor de deslocamento do objeto visual.Gets or sets the offset value of the visual object.

(Herdado de Visual)
VisualOpacity

Obtém ou define a opacidade do Visual.Gets or sets the opacity of the Visual.

(Herdado de Visual)
VisualOpacityMask

Obtém ou define o valor Brush que representa a máscara de opacidade do Visual.Gets or sets the Brush value that represents the opacity mask of the Visual.

(Herdado de Visual)
VisualParent

Obtém o pai da árvore visual do objeto visual.Gets the visual tree parent of the visual object.

(Herdado de Visual)
VisualScrollableAreaClip

Obtém ou define uma área rolável recortada para o Visual.Gets or sets a clipped scrollable area for the Visual.

(Herdado de Visual)
VisualTextHintingMode

Obtém ou define o TextHintingMode do Visual.Gets or sets the TextHintingMode of the Visual.

(Herdado de Visual)
VisualTextRenderingMode

Obtém ou define o TextRenderingMode do Visual.Gets or sets the TextRenderingMode of the Visual.

(Herdado de Visual)
VisualTransform

Obtém ou define o valor Transform para o Visual.Gets or sets the Transform value for the Visual.

(Herdado de Visual)
VisualXSnappingGuidelines

Obtém ou define a coleção de diretrizes (vertical) da coordenada X.Gets or sets the x-coordinate (vertical) guideline collection.

(Herdado de Visual)
VisualYSnappingGuidelines

Obtém ou define a coleção de diretrizes (horizontal) da coordenada y.Gets or sets the y-coordinate (horizontal) guideline collection.

(Herdado de Visual)
XSnappingGuidelines

Obtém ou define a orientação de X (horizontal) para o ContainerVisual.Gets or sets the X (horizontal) guideline for the ContainerVisual.

YSnappingGuidelines

Obtém ou define a orientação de Y (vertical) para o ContainerVisual.Gets or sets the Y (vertical) guideline for the ContainerVisual.

Métodos

AddVisualChild(Visual)

Define a relação pai-filho entre dois visuais.Defines the parent-child relationship between two visuals.

(Herdado de Visual)
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)
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)
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)
FindCommonVisualAncestor(DependencyObject)

Retorna o ancestral comum de dois objetos visuais.Returns the common ancestor of two visual objects.

(Herdado de Visual)
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)
GetVisualChild(Int32)

Retorna um Visual filho especificado para o ContainerVisual pai.Returns a specified child Visual for the parent ContainerVisual.

HitTest(HitTestFilterCallback, HitTestResultCallback, HitTestParameters)

Inicia um teste de clique no ContainerVisual usando os objetos HitTestFilterCallback e HitTestResultCallback.Initiates a hit test on the ContainerVisual by using the HitTestFilterCallback and HitTestResultCallback objects.

HitTest(Point)

Retorna o primeiro objeto visual de um teste de clique especificando um Point.Returns the top-most visual object of a hit test by specifying a Point.

HitTestCore(GeometryHitTestParameters)

Determina se um valor de geometria está dentro dos limites do objeto visual.Determines whether a geometry value is within the bounds of the visual object.

(Herdado de Visual)
HitTestCore(PointHitTestParameters)

Determina se um valor de coordenadas de ponto está dentro dos limites do objeto visual.Determines whether a point coordinate value is within the bounds of the visual object.

(Herdado de Visual)
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)
IsAncestorOf(DependencyObject)

Determina se o objeto visual é um ancestral do objeto visual descendente.Determines whether the visual object is an ancestor of the descendant visual object.

(Herdado de Visual)
IsDescendantOf(DependencyObject)

Determina se o objeto visual é um descendente do objeto visual ancestral.Determines whether the visual object is a descendant of the ancestor visual object.

(Herdado de Visual)
MemberwiseClone()

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

(Herdado de Object)
OnDpiChanged(DpiScale, DpiScale)

Chamado quando o DPI em que esse modo de exibição é renderizado é alterada.Called when the DPI at which this View is rendered changes.

(Herdado de Visual)
OnPropertyChanged(DependencyPropertyChangedEventArgs)

Invocado sempre que o valor efetivo de qualquer propriedade de dependência nesse DependencyObject for atualizada.Invoked whenever the effective value of any dependency property on this DependencyObject has been updated. A propriedade de dependência específica que mudou é relatada os dados do evento.The specific dependency property that changed is reported in the event data.

(Herdado de DependencyObject)
OnVisualChildrenChanged(DependencyObject, DependencyObject)

Chamado quando o VisualCollection de um objeto visual é modificado.Called when the VisualCollection of the visual object is modified.

(Herdado de Visual)
OnVisualParentChanged(DependencyObject)

Chamado quando o pai do objeto visual for alterado.Called when the parent of the visual object is changed.

(Herdado de Visual)
PointFromScreen(Point)

Converte um Point em coordenadas de tela em um Point que representa o sistema de coordenadas atual do Visual.Converts a Point in screen coordinates into a Point that represents the current coordinate system of the Visual.

(Herdado de Visual)
PointToScreen(Point)

Converte um Point que representa o sistema de coordenadas atual do Visual em um Point nas coordenadas da tela.Converts a Point that represents the current coordinate system of the Visual into a Point in screen coordinates.

(Herdado de Visual)
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)
RemoveVisualChild(Visual)

Remove a relação pai-filho entre dois visuais.Removes the parent-child relationship between two visuals.

(Herdado de Visual)
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)
TransformToAncestor(Visual)

Retorna uma transformação que pode ser usada para transformar as coordenadas do Visual para o ancestral Visual especificado do objeto visual.Returns a transform that can be used to transform coordinates from the Visual to the specified Visual ancestor of the visual object.

(Herdado de Visual)
TransformToAncestor(Visual3D)

Retorna uma transformação que pode ser usada para transformar as coordenadas do Visual para o ancestral Visual3D especificado do objeto visual.Returns a transform that can be used to transform coordinates from the Visual to the specified Visual3D ancestor of the visual object.

(Herdado de Visual)
TransformToDescendant(Visual)

Retorna uma transformação que pode ser usada para transformar as coordenadas do Visual até o descendente do objeto visual especificado.Returns a transform that can be used to transform coordinates from the Visual to the specified visual object descendant.

(Herdado de Visual)
TransformToVisual(Visual)

Retorna uma transformação que pode ser usada para transformar as coordenadas do Visual até o objeto visual especificado.Returns a transform that can be used to transform coordinates from the Visual to the specified visual object.

(Herdado de Visual)
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)

Aplica-se a