ContainerVisual Clase

Definición

Espacio de nombres:

System.Windows.Media

Ensamblado:

PresentationCore.dll

Administra una colección 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

Herencia

Object

DispatcherObject

DependencyObject

Visual

ContainerVisual

Derivado

System.Windows.Media.DrawingVisual

System.Windows.Media.HostVisual

Ejemplos

En el ejemplo siguiente se muestra cómo crear un ContainerVisual objeto que se usa como elemento primario para dos DrawingVisual objetos. Los objetos que se agregan al ContainerVisual objeto se deben agregar en orden z inverso (inferior a arriba) para asegurarse de que se están representando en el orden de dibujo correcto. Para que el árbol visual se enumere correctamente, el ejemplo proporciona implementaciones invalidadas del método y VisualChildrenCount la GetVisualChild propiedad .

// 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

Comentarios

La ContainerVisual clase se usa como contenedor para una colección de Visual objetos . La DrawingVisual clase deriva de la ContainerVisual clase , de modo que la DrawingVisual clase también puede contener una colección de objetos visuales.

Constructores

ContainerVisual()

Crea una nueva instancia de la clase ContainerVisual.

Propiedades

BitmapEffect	Obsoleto. Obsoleto. Obtiene o establece un valor de BitmapEffect para ContainerVisual.
BitmapEffectInput	Obsoleto. Obsoleto. Obtiene o establece un valor de BitmapEffectInput para ContainerVisual.
CacheMode	Obtiene o establece una representación en caché del objeto ContainerVisual.
Children	Obtiene la colección secundaria de ContainerVisual.
Clip	Obtiene o establece la región de recorte de ContainerVisual.
ContentBounds	Obtiene el rectángulo de selección para el contenido de ContainerVisual.
DependencyObjectType	Obtiene el DependencyObjectType objeto que encapsula el tipo CLR de esta instancia. (Heredado de DependencyObject)
DescendantBounds	Obtiene la unión de todos los rectángulos de selección del contenido de todos los descendientes del objeto ContainerVisual, sin incluir el contenido de ContainerVisual.
Dispatcher	Obtiene el objeto Dispatcher al que está asociado DispatcherObject. (Heredado de DispatcherObject)
Effect	Obtiene o establece el efecto de imagen que se va a aplicar a ContainerVisual.
IsSealed	Obtiene un valor que indica si esta instancia está actualmente sellada (es de solo lectura). (Heredado de DependencyObject)
Offset	Obtiene o establece el valor de desplazamiento de ContainerVisual desde su punto de referencia.
Opacity	Obtiene o establece la opacidad de ContainerVisual, siendo 0 = transparente y 1 = opaco.
OpacityMask	Obtiene o establece un pincel que especifica una posible máscara de opacidad para ContainerVisual.
Parent	Obtiene el objeto Visual primario de ContainerVisual.
Transform	Obtiene o establece la transformación aplicada a ContainerVisual.
VisualBitmapEffect	Obsoleto. Obsoleto. Obtiene o establece el valor de BitmapEffect para Visual. (Heredado de Visual)
VisualBitmapEffectInput	Obsoleto. Obsoleto. Obtiene o establece el valor de BitmapEffectInput para Visual. (Heredado de Visual)
VisualBitmapScalingMode	Obtiene o establece el objeto BitmapScalingMode para Visual. (Heredado de Visual)
VisualCacheMode	Obtiene o establece una representación en caché del objeto Visual. (Heredado de Visual)
VisualChildrenCount	Obtiene el número de elementos secundarios del ContainerVisual.
VisualClearTypeHint	Obtiene o establece el valor de ClearTypeHint que determina cómo se presenta ClearType en el objeto Visual. (Heredado de Visual)
VisualClip	Obtiene o establece la región de recorte del objeto Visual como valor de Geometry. (Heredado de Visual)
VisualEdgeMode	Obtiene o establece el modo de borde del objeto Visual como valor de EdgeMode. (Heredado de Visual)
VisualEffect	Obtiene o establece el efecto de imagen que se va a aplicar a Visual. (Heredado de Visual)
VisualOffset	Obtiene o establece el valor de desplazamiento del objeto visual. (Heredado de Visual)
VisualOpacity	Obtiene o establece la opacidad del objeto Visual. (Heredado de Visual)
VisualOpacityMask	Obtiene o establece el valor de Brush que representa la máscara de opacidad del objeto Visual. (Heredado de Visual)
VisualParent	Obtiene el objeto primario del árbol visual del objeto visual. (Heredado de Visual)
VisualScrollableAreaClip	Obtiene o establece un área de recorte desplazable del objeto Visual. (Heredado de Visual)
VisualTextHintingMode	Obtiene o establece TextHintingMode de Visual. (Heredado de Visual)
VisualTextRenderingMode	Obtiene o establece TextRenderingMode de Visual. (Heredado de Visual)
VisualTransform	Obtiene o establece el valor de Transform para Visual. (Heredado de Visual)
VisualXSnappingGuidelines	Obtiene o establece la colección de instrucciones de la coordenada X (vertical). (Heredado de Visual)
VisualYSnappingGuidelines	Obtiene o establece la colección de instrucciones de la coordenada y (horizontal). (Heredado de Visual)
XSnappingGuidelines	Obtiene o establece la coordenada X (horizontal) de ContainerVisual.
YSnappingGuidelines	Obtiene o establece la coordenada Y (vertical) de ContainerVisual.

Métodos

AddVisualChild(Visual)	Define la relación primario-secundario entre dos objetos visuales. (Heredado de Visual)
CheckAccess()	Determina si el subproceso de la llamada tiene acceso a DispatcherObject. (Heredado de DispatcherObject)
ClearValue(DependencyProperty)	Borra el valor local de una propiedad. La propiedad que se va a borrar se especifica mediante un identificador DependencyProperty. (Heredado de DependencyObject)
ClearValue(DependencyPropertyKey)	Borra el valor local de una propiedad de solo lectura. La propiedad que se va a borrar se especifica mediante un DependencyPropertyKey. (Heredado de DependencyObject)
CoerceValue(DependencyProperty)	Convierte el valor de la propiedad de dependencia especificada. Esto se logra invocando cualquier función CoerceValueCallback especificada en los metadatos de la propiedad de dependencia tal como existe en la clase DependencyObject que llama. (Heredado de DependencyObject)
Equals(Object)	Determina si un objeto DependencyObject proporcionado es equivalente al objeto DependencyObject actual. (Heredado de DependencyObject)
FindCommonVisualAncestor(DependencyObject)	Devuelve el antecesor común de dos objetos visuales. (Heredado de Visual)
GetHashCode()	Obtiene un código hash de este objeto DependencyObject. (Heredado de DependencyObject)
GetLocalValueEnumerator()	Crea un enumerador especializado para determinar qué propiedades de dependencia han establecido localmente los valores en DependencyObject. (Heredado de DependencyObject)
GetType()	Obtiene el Type de la instancia actual. (Heredado de Object)
GetValue(DependencyProperty)	Devuelve el valor efectivo actual de una propiedad de dependencia en esta instancia de un DependencyObject. (Heredado de DependencyObject)
GetVisualChild(Int32)	Devuelve un elemento secundario Visual especificado para el elemento primario ContainerVisual.
HitTest(HitTestFilterCallback, HitTestResultCallback, HitTestParameters)	Inicia una prueba de posicionamiento en ContainerVisual mediante los objetos HitTestFilterCallback y HitTestResultCallback.
HitTest(Point)	Devuelve el objeto visual de nivel superior de una prueba de posicionamiento al especificar un objeto Point.
HitTestCore(GeometryHitTestParameters)	Determina si un valor geométrico está dentro de los límites del objeto visual. (Heredado de Visual)
HitTestCore(PointHitTestParameters)	Determina si un valor de coordenada de punto está dentro de los límites del objeto visual. (Heredado de Visual)
InvalidateProperty(DependencyProperty)	Vuelve a evaluar el valor efectivo para la propiedad de dependencia especificada. (Heredado de DependencyObject)
IsAncestorOf(DependencyObject)	Determina si el objeto visual es un antecesor del objeto visual descendiente. (Heredado de Visual)
IsDescendantOf(DependencyObject)	Determina si el objeto visual es un descendiente del objeto visual antecesor. (Heredado de Visual)
MemberwiseClone()	Crea una copia superficial del Object actual. (Heredado de Object)
OnDpiChanged(DpiScale, DpiScale)	Llamado cuando cambia el valor de PPP en el que este cuadro de texto enriquecido se representa. (Heredado de Visual)
OnPropertyChanged(DependencyPropertyChangedEventArgs)	Se invoca cuando se actualiza el valor efectivo de alguna propiedad de dependencia en este DependencyObject. La propiedad de dependencia específica que cambió se notifica en los datos de evento. (Heredado de DependencyObject)
OnVisualChildrenChanged(DependencyObject, DependencyObject)	Se le llama cuando se modifica la colección VisualCollection del objeto visual. (Heredado de Visual)
OnVisualParentChanged(DependencyObject)	Se le llama cuando se cambia el objeto primario del objeto visual. (Heredado de Visual)
PointFromScreen(Point)	Convierte un objeto Point en coordenadas de pantalla en un objeto Point que representa el sistema de coordenadas actual de Visual. (Heredado de Visual)
PointToScreen(Point)	Convierte un objeto Point que representa el sistema de coordenadas actual del objeto Visual en un objeto Point de coordenadas de pantalla. (Heredado de Visual)
ReadLocalValue(DependencyProperty)	Devuelve el valor local de una propiedad de dependencia, si existe. (Heredado de DependencyObject)
RemoveVisualChild(Visual)	Quita la relación primario-secundario entre dos objetos visuales. (Heredado de Visual)
SetCurrentValue(DependencyProperty, Object)	Establece el valor de una propiedad de dependencia sin cambiar el origen del valor. (Heredado de DependencyObject)
SetValue(DependencyProperty, Object)	Establece el valor local de una propiedad de dependencia, especificado mediante el identificador de la propiedad de dependencia. (Heredado de DependencyObject)
SetValue(DependencyPropertyKey, Object)	Establece el valor local de una propiedad de dependencia de solo lectura, especificado por el identificador DependencyPropertyKey de la propiedad de dependencia. (Heredado de DependencyObject)
ShouldSerializeProperty(DependencyProperty)	Devuelve un valor que indica si los procesos de serialización deben serializar el valor de la propiedad de dependencia especificada. (Heredado de DependencyObject)
ToString()	Devuelve una cadena que representa el objeto actual. (Heredado de Object)
TransformToAncestor(Visual)	Devuelve una transformación que se puede usar para transformar las coordenadas desde el objeto Visual en el antecesor del objeto Visual especificado del objeto visual. (Heredado de Visual)
TransformToAncestor(Visual3D)	Devuelve una transformación que se puede usar para transformar las coordenadas desde el objeto Visual en el antecesor del objeto Visual3D especificado del objeto visual. (Heredado de Visual)
TransformToDescendant(Visual)	Devuelve una transformación que se puede usar para transformar las coordenadas desde el objeto Visual en el descendiente del objeto visual especificado. (Heredado de Visual)
TransformToVisual(Visual)	Devuelve una transformación que se puede usar para transformar las coordenadas desde el objeto Visual en el objeto visual especificado. (Heredado de Visual)
VerifyAccess()	Exige que el subproceso de la llamada tenga acceso a DispatcherObject. (Heredado de DispatcherObject)