ContainerVisual Classe
Definição
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
- 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) |