Compartir vía


ContainerVisual Clase

Definición

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
Derivado

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)

Se aplica a