ContainerVisual Classe

Referência

Definição

Namespace:: System.Windows.Media

Assembly:: PresentationCore.dll

Importante

Algumas informações se referem a produtos de pré-lançamento que podem ser substancialmente modificados antes do lançamento. A Microsoft não oferece garantias, expressas ou implícitas, das informações aqui fornecidas.

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: Object

DispatcherObject

DependencyObject

Visual
ContainerVisual

Derivado: System.Windows.Media.DrawingVisual

System.Windows.Media.HostVisual

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

Partilhar via