ContainerVisual Classe

Definição

Espaço de Nomes:: System.Windows.Media

Assemblagem:: PresentationCore.dll

Importante

Algumas informações dizem respeito a um produto pré-lançado que pode ser substancialmente modificado antes de ser lançado. A Microsoft não faz garantias, de forma expressa ou implícita, em relação à informação aqui apresentada.

Gerir uma coleção de Visual objetos.

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

Observações

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 esta DrawingVisual também pode conter uma coleção de objetos visuais.

Construtores

Name	Description
ContainerVisual()	Cria uma nova instância da ContainerVisual classe.

Propriedades

Name	Description
BitmapEffect	Obsoleto. Obsoleto. Obtém ou define um BitmapEffect valor para o ContainerVisual.
BitmapEffectInput	Obsoleto. Obsoleto. Obtém ou define um BitmapEffectInput valor para o ContainerVisual.
CacheMode	Obtém ou define uma representação em cache do ContainerVisual.
Children	Obtém a coleção de filhos do ContainerVisual.
Clip	Obtém ou define a região de clipping do ContainerVisual.
ContentBounds	Obtém a caixa delimitadora para o conteúdo do ContainerVisual.
DependencyObjectType	Obtém o DependencyObjectType que envolve o tipo CLR desta 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 sem incluir o conteúdo do ContainerVisual.
Dispatcher	Percebe o Dispatcher que isto DispatcherObject está associado. (Herdado de DispatcherObject)
Effect	Obtém ou define o efeito bitmap para se aplicar ao ContainerVisual.
IsSealed	Recebe um valor que indica se esta instância está atualmente selada (apenas leitura). (Herdado de DependencyObject)
Offset	Obtém ou define o valor de deslocamento do ContainerVisual 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 possível máscara de opacidade para o ContainerVisual.
Parent	Obtém o progenitor Visual para o ContainerVisual.
Transform	Obtém ou define a transformada que é aplicada ao ContainerVisual.
VisualBitmapEffect	Obsoleto. Obsoleto. Obtém ou define o BitmapEffect valor para o Visual. (Herdado de Visual)
VisualBitmapEffectInput	Obsoleto. Obsoleto. Obtém ou define o BitmapEffectInput valor para o Visual. (Herdado de Visual)
VisualBitmapScalingMode	Obtém ou define para BitmapScalingMode o Visual. (Herdado de Visual)
VisualCacheMode	Obtém ou define uma representação 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 clip de como Visual valor Geometry . (Herdado de Visual)
VisualEdgeMode	Obtém ou define o modo de aresta de como Visual um EdgeMode valor. (Herdado de Visual)
VisualEffect	Obtém ou define o efeito bitmap para se aplicar 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 Brush valor 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 deslocá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 Transform valor para o Visual. (Herdado de Visual)
VisualXSnappingGuidelines	Obtém ou define a coleção de orientações de coordenadas x (verticais). (Herdado de Visual)
VisualYSnappingGuidelines	Obtém ou define a coleção de orientações de coordenadas y (horizontais). (Herdado de Visual)
XSnappingGuidelines	Obtém ou define a diretriz X (horizontal) para o ContainerVisual.
YSnappingGuidelines	Obtém ou define a diretriz Y (vertical) para o ContainerVisual.

Métodos

Name	Description
AddVisualChild(Visual)	Define a relação pai-filho entre dois visuais. (Herdado de Visual)
CheckAccess()	Determina se o thread que chama 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 DependencyProperty identificador. (Herdado de DependencyObject)
ClearValue(DependencyPropertyKey)	Limpa o valor local de uma propriedade de apenas leitura. O imóvel a ser limpo é especificado por um DependencyPropertyKey. (Herdado de DependencyObject)
CoerceValue(DependencyProperty)	Coage o valor da propriedade de dependência especificada. Isto é conseguido invocando qualquer CoerceValueCallback função especificada nos metadados da propriedade para a propriedade de dependência tal como existe na chamada DependencyObject. (Herdado de DependencyObject)
Equals(Object)	Determina se um fornecido DependencyObject é equivalente à corrente DependencyObject. (Herdado de DependencyObject)
FindCommonVisualAncestor(DependencyObject)	Devolve o ancestral comum de dois objetos visuais. (Herdado de Visual)
GetHashCode()	Obtém um código de hash para isto DependencyObject. (Herdado de DependencyObject)
GetLocalValueEnumerator()	Cria um enumerador especializado para determinar quais as propriedades de dependência que têm valores localmente definidos neste DependencyObject. (Herdado de DependencyObject)
GetType()	Obtém o Type da instância atual. (Herdado de Object)
GetValue(DependencyProperty)	Devolve o valor efetivo atual de uma propriedade de dependência nesta instância de um DependencyObject. (Herdado de DependencyObject)
GetVisualChild(Int32)	Devolve um filho Visual especificado para o progenitor ContainerVisual.
HitTest(HitTestFilterCallback, HitTestResultCallback, HitTestParameters)	Inicia um teste de acerto no ContainerVisual usando os HitTestFilterCallback objetos e HitTestResultCallback .
HitTest(Point)	Devolve o objeto visual mais topo de um teste de acerto especificando um Point.
HitTestCore(GeometryHitTestParameters)	Determina se um valor geométrico está dentro dos limites do objeto visual. (Herdado de Visual)
HitTestCore(PointHitTestParameters)	Determina se o valor de uma coordenada pontual está dentro dos limites do objeto visual. (Herdado de Visual)
InvalidateProperty(DependencyProperty)	Reavalia o valor efetivo da 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 é descendente do objeto visual ancestral. (Herdado de Visual)
MemberwiseClone()	Cria uma cópia superficial do atual Object. (Herdado de Object)
OnDpiChanged(DpiScale, DpiScale)	Chamada quando o DPI em que esta Vista é renderizada muda. (Herdado de Visual)
OnPropertyChanged(DependencyPropertyChangedEventArgs)	Invocado sempre que o valor efetivo de qualquer propriedade de dependência disto DependencyObject for atualizado. A propriedade específica da dependência que mudou é reportada nos dados do evento. (Herdado de DependencyObject)
OnVisualChildrenChanged(DependencyObject, DependencyObject)	Chamado quando o VisualCollection objeto visual é modificado. (Herdado de Visual)
OnVisualParentChanged(DependencyObject)	Chamada quando o pai do objeto visual é alterado. (Herdado de Visual)
PointFromScreen(Point)	Converte coordenadas Point no ecrã 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 de o Visual em Point coordenadas no ecrã. (Herdado de Visual)
ReadLocalValue(DependencyProperty)	Devolve o valor local de uma propriedade de dependência, se esta existir. (Herdado de DependencyObject)
RemoveVisualChild(Visual)	Remove a relação entre pais e filhos entre dois visuais. (Herdado de Visual)
SetCurrentValue(DependencyProperty, Object)	Define o valor de uma propriedade de dependência sem alterar a sua fonte de valor. (Herdado de DependencyObject)
SetValue(DependencyProperty, Object)	Define o valor local de uma propriedade de dependência, especificado pelo seu identificador de propriedade de dependência. (Herdado de DependencyObject)
SetValue(DependencyPropertyKey, Object)	Define o valor local de uma propriedade de dependência somente de leitura, especificado pelo DependencyPropertyKey identificador da propriedade de dependência. (Herdado de DependencyObject)
ShouldSerializeProperty(DependencyProperty)	Devolve um valor que indica se os processos de serialização devem serializar o valor da propriedade de dependência fornecida. (Herdado de DependencyObject)
ToString()	Devolve uma cadeia que representa o objeto atual. (Herdado de Object)
TransformToAncestor(Visual)	Devolve uma transformação que pode ser usada para transformar coordenadas do Visual para o ancestral especificado Visual do objeto visual. (Herdado de Visual)
TransformToAncestor(Visual3D)	Devolve uma transformação que pode ser usada para transformar coordenadas do Visual para o ancestral especificado Visual3D do objeto visual. (Herdado de Visual)
TransformToDescendant(Visual)	Devolve uma transformada que pode ser usada para transformar coordenadas do Visual para o descendente do objeto visual especificado. (Herdado de Visual)
TransformToVisual(Visual)	Devolve uma transformada que pode ser usada para transformar coordenadas de para Visual o objeto visual especificado. (Herdado de Visual)
VerifyAccess()	Faz cumprir que o thread que chama tem acesso a este DispatcherObject. (Herdado de DispatcherObject)

Aplica-se a

Comentários

Esta página foi útil?