Partilhar via


ContainerVisual Classe

Definição

Gerencia uma coleção de objetos Visual.

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 ContainerVisual objeto que é usado como pai para dois DrawingVisual objetos. Objetos que são adicionados ao ContainerVisual objeto devem ser adicionados na ordem z inversa (de baixo para cima) para garantir que estão sendo renderizados na ordem de desenho correta. Para que a árvore visual seja enumerada corretamente, o exemplo fornece implementações substituídas do GetVisualChild método e VisualChildrenCount da propriedade.

// 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 ContainerVisual classe é usada como um contêiner para uma coleção de Visual objetos. A DrawingVisual classe deriva da ContainerVisual classe, de modo que a DrawingVisual classe também pode conter uma coleção de objetos visuais.

Construtores

ContainerVisual()

Cria uma nova instância da classe ContainerVisual.

Propriedades

BitmapEffect
Obsoleto.
Obsoleto.

Obtém ou define um valor BitmapEffect para o ContainerVisual.

BitmapEffectInput
Obsoleto.
Obsoleto.

Obtém ou define um valor BitmapEffectInput para o ContainerVisual.

CacheMode

Obtém ou define uma representação armazenada em cache do ContainerVisual.

Children

Obtém a coleção filho do ContainerVisual.

Clip

Obtém ou define a área de recorte do ContainerVisual.

ContentBounds

Obtém a caixa delimitadora do conteúdo do ContainerVisual.

DependencyObjectType

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

(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.

Dispatcher

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

(Herdado de DispatcherObject)
Effect

Obtém ou define o efeito de bitmap a ser aplicado ao ContainerVisual.

IsSealed

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

(Herdado de DependencyObject)
Offset

Obtém ou define o valor de deslocamento do ContainerVisual do seu ponto de referência.

Opacity

Obtém ou define a opacidade do ContainerVisual, com base em 0 = transparente, 1 = opaco.

OpacityMask

Obtém ou define um pincel que especifica uma máscara de opacidade possível para o ContainerVisual.

Parent

Obtém o Visual pai para o ContainerVisual.

Transform

Obtém ou define a transformação aplicada ao ContainerVisual.

VisualBitmapEffect
Obsoleto.
Obsoleto.

Obtém ou define o valor BitmapEffect para o Visual.

(Herdado de Visual)
VisualBitmapEffectInput
Obsoleto.
Obsoleto.

Obtém ou define o valor BitmapEffectInput para o Visual.

(Herdado de Visual)
VisualBitmapScalingMode

Obtém ou define o BitmapScalingMode do Visual.

(Herdado de Visual)
VisualCacheMode

Obtém ou define uma representação armazenada em cache do Visual.

(Herdado de Visual)
VisualChildrenCount

Obtém o número de filhos para o ContainerVisual.

VisualClearTypeHint

Obtém ou define o ClearTypeHint que determina como o ClearType é renderizado no Visual.

(Herdado de Visual)
VisualClip

Obtém ou define a região de corte do Visual como um valor Geometry.

(Herdado de Visual)
VisualEdgeMode

Obtém ou define o modo de borda do Visual com um valor EdgeMode.

(Herdado de Visual)
VisualEffect

Obtém ou define o efeito de bitmap a ser aplicado ao Visual.

(Herdado de Visual)
VisualOffset

Obtém ou define o valor de deslocamento do objeto visual.

(Herdado de Visual)
VisualOpacity

Obtém ou define a opacidade do Visual.

(Herdado de Visual)
VisualOpacityMask

Obtém ou define o valor Brush que representa a máscara de opacidade do Visual.

(Herdado de Visual)
VisualParent

Obtém o pai da árvore visual do objeto visual.

(Herdado de Visual)
VisualScrollableAreaClip

Obtém ou define uma área rolável recortada para o Visual.

(Herdado de Visual)
VisualTextHintingMode

Obtém ou define o TextHintingMode do Visual.

(Herdado de Visual)
VisualTextRenderingMode

Obtém ou define o TextRenderingMode do Visual.

(Herdado de Visual)
VisualTransform

Obtém ou define o valor Transform para o Visual.

(Herdado de Visual)
VisualXSnappingGuidelines

Obtém ou define a coleção de diretrizes (vertical) da coordenada X.

(Herdado de Visual)
VisualYSnappingGuidelines

Obtém ou define a coleção de diretrizes (horizontal) da coordenada y.

(Herdado de Visual)
XSnappingGuidelines

Obtém ou define a orientação de X (horizontal) para o ContainerVisual.

YSnappingGuidelines

Obtém ou define a orientação de Y (vertical) para o ContainerVisual.

Métodos

AddVisualChild(Visual)

Define a relação pai-filho entre dois visuais.

(Herdado de Visual)
CheckAccess()

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

(Herdado de DispatcherObject)
ClearValue(DependencyProperty)

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

(Herdado de DependencyObject)
ClearValue(DependencyPropertyKey)

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

(Herdado de DependencyObject)
CoerceValue(DependencyProperty)

Converte o valor da propriedade de dependência especificada. 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.

(Herdado de DependencyObject)
Equals(Object)

Determina se um DependencyObject fornecido é equivalente ao DependencyObject atual.

(Herdado de DependencyObject)
FindCommonVisualAncestor(DependencyObject)

Retorna o ancestral comum de dois objetos visuais.

(Herdado de Visual)
GetHashCode()

Obtém o código hash para esse DependencyObject.

(Herdado de DependencyObject)
GetLocalValueEnumerator()

Cria um enumerador especializado para determinar quais propriedades de dependência têm valores definidos localmente nessa 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 nessa instância de um DependencyObject.

(Herdado de DependencyObject)
GetVisualChild(Int32)

Retorna um Visual filho especificado para o ContainerVisual pai.

HitTest(HitTestFilterCallback, HitTestResultCallback, HitTestParameters)

Inicia um teste de clique no ContainerVisual usando os objetos HitTestFilterCallback e HitTestResultCallback.

HitTest(Point)

Retorna o primeiro objeto visual de um teste de clique especificando um Point.

HitTestCore(GeometryHitTestParameters)

Determina se um valor de geometria está dentro dos limites do objeto visual.

(Herdado de Visual)
HitTestCore(PointHitTestParameters)

Determina se um valor de coordenadas de ponto está dentro dos limites do objeto visual.

(Herdado de Visual)
InvalidateProperty(DependencyProperty)

Reavalia o valor efetivo para a propriedade de dependência especificada.

(Herdado de DependencyObject)
IsAncestorOf(DependencyObject)

Determina se o objeto visual é um ancestral do objeto visual descendente.

(Herdado de Visual)
IsDescendantOf(DependencyObject)

Determina se o objeto visual é um descendente do objeto visual ancestral.

(Herdado de Visual)
MemberwiseClone()

Cria uma cópia superficial do Object atual.

(Herdado de Object)
OnDpiChanged(DpiScale, DpiScale)

Chamado quando o DPI em que esse modo de exibição é renderizado é alterada.

(Herdado de Visual)
OnPropertyChanged(DependencyPropertyChangedEventArgs)

Invocado sempre que o valor efetivo de qualquer propriedade de dependência nesse DependencyObject for atualizado. A propriedade de dependência específica que mudou é relatada os dados do evento.

(Herdado de DependencyObject)
OnVisualChildrenChanged(DependencyObject, DependencyObject)

Chamado quando o VisualCollection de um objeto visual é modificado.

(Herdado de Visual)
OnVisualParentChanged(DependencyObject)

Chamado quando o pai do objeto visual for alterado.

(Herdado de Visual)
PointFromScreen(Point)

Converte um Point em coordenadas de tela em um Point que representa o sistema de coordenadas atual do 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.

(Herdado de Visual)
ReadLocalValue(DependencyProperty)

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

(Herdado de DependencyObject)
RemoveVisualChild(Visual)

Remove a relação pai-filho entre dois visuais.

(Herdado de Visual)
SetCurrentValue(DependencyProperty, Object)

Define o valor da propriedade de dependência sem alterar a origem do valor.

(Herdado de DependencyObject)
SetValue(DependencyProperty, Object)

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

(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.

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

Retorna uma transformação que pode ser usada para transformar as coordenadas do Visual para o ancestral Visual especificado do objeto visual.

(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.

(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.

(Herdado de Visual)
TransformToVisual(Visual)

Retorna uma transformação que pode ser usada para transformar as coordenadas do Visual até o objeto visual especificado.

(Herdado de Visual)
VerifyAccess()

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

(Herdado de DispatcherObject)

Aplica-se a