ContainerVisual Classe

Definizione

Gestisce una raccolta di oggetti Visual.Manages a collection of Visual objects.

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
Ereditarietà
Derivato

Esempi

Nell'esempio seguente viene illustrato come creare un oggetto ContainerVisual utilizzato come elemento padre per due oggetti DrawingVisual.The following example shows how to create a ContainerVisual object that is used as the parent for two DrawingVisual objects. Gli oggetti che vengono aggiunti all'oggetto ContainerVisual devono essere aggiunti in ordine z inverso (dal basso verso l'alto) per assicurarsi che vengano renderizzati nell'ordine di disegno corretto.Objects that are added to the ContainerVisual object must be added in reverse z-order (bottom to top) to ensure they are rendering in the correct drawing order. Affinché la struttura ad albero visuale venga enumerata correttamente, nell'esempio vengono fornite implementazioni sottoposte a override del metodo GetVisualChild e della proprietà VisualChildrenCount.In order for the visual tree to be enumerated correctly, the example provides overridden implementations of the GetVisualChild method and VisualChildrenCount property.

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

Commenti

La classe ContainerVisual viene utilizzata come contenitore per una raccolta di oggetti Visual.The ContainerVisual class is used as a container for a collection of Visual objects. La classe DrawingVisual deriva dalla classe ContainerVisual, in modo che la classe DrawingVisual possa contenere anche una raccolta di oggetti visivi.The DrawingVisual class derives from the ContainerVisual class, such that the DrawingVisual class can also contain a collection of visual objects.

Costruttori

ContainerVisual()

Crea una nuova istanza della classe ContainerVisual.Creates a new instance of the ContainerVisual class.

Proprietà

BitmapEffect

Ottiene o imposta un valore di BitmapEffect per l'oggetto ContainerVisual.Gets or sets a BitmapEffect value for the ContainerVisual.

BitmapEffectInput

Ottiene o imposta un valore di BitmapEffectInput per l'oggetto ContainerVisual.Gets or sets a BitmapEffectInput value for the ContainerVisual.

CacheMode

Ottiene o imposta una rappresentazione nascosta dell'oggetto ContainerVisual.Gets or sets a cached representation of the ContainerVisual.

Children

Ottiene l'insieme di oggetti figlio dell'oggetto ContainerVisual.Gets the child collection of the ContainerVisual.

Clip

Ottiene o imposta l'area di ritaglio dell'oggetto ContainerVisual.Gets or sets the clipping region of the ContainerVisual.

ContentBounds

Ottiene il riquadro delimitatore del testo per il contenuto dell'oggetto ContainerVisual.Gets the bounding box for the contents of the ContainerVisual.

DependencyObjectType

Ottiene la classe DependencyObjectType che include il tipo CLRCLR di questa istanza.Gets the DependencyObjectType that wraps the CLRCLR type of this instance.

(Ereditato da DependencyObject)
DescendantBounds

Ottiene l'unione di tutti i riquadri delimitatori del contenuto per tutti i discendenti dell'oggetto ContainerVisual, escluso il contenuto dell'oggetto ContainerVisual.Gets the union of all the content bounding boxes for all of the descendants of the ContainerVisual, but not including the contents of the ContainerVisual.

Dispatcher

Ottiene l'oggetto Dispatcher associato a DispatcherObject.Gets the Dispatcher this DispatcherObject is associated with.

(Ereditato da DispatcherObject)
Effect

Ottiene o imposta l'effetto bitmap da applicare all'oggetto ContainerVisual.Gets or sets the bitmap effect to apply to the ContainerVisual.

IsSealed

Ottiene un valore che indica se l'istanza è attualmente sealed (di sola lettura).Gets a value that indicates whether this instance is currently sealed (read-only).

(Ereditato da DependencyObject)
Offset

Ottiene o imposta il valore di offset dell'oggetto ContainerVisual in base al relativo punto di riferimento.Gets or sets the offset value of the ContainerVisual from its reference point.

Opacity

Ottiene o imposta l'opacità dell'oggetto ContainerVisual, in base alle impostazioni 0 = trasparente e 1 = opaco.Gets or sets the opacity of the ContainerVisual, based on 0=transparent, 1=opaque.

OpacityMask

Ottiene o imposta un pennello che specifica una possibile maschera di opacità per l'oggetto ContainerVisual.Gets or sets a brush that specifies a possible opacity mask for the ContainerVisual.

Parent

Ottiene l'oggetto Visual padre dell'oggetto ContainerVisual.Gets the parent Visual for the ContainerVisual.

Transform

Ottiene o imposta la trasformazione applicata all'oggetto ContainerVisual.Gets or sets the transform that is applied to the ContainerVisual.

VisualBitmapEffect

Ottiene o imposta il valore di BitmapEffect per Visual.Gets or sets the BitmapEffect value for the Visual.

(Ereditato da Visual)
VisualBitmapEffectInput

Ottiene o imposta il valore di BitmapEffectInput per Visual.Gets or sets the BitmapEffectInput value for the Visual.

(Ereditato da Visual)
VisualBitmapScalingMode

Ottiene o imposta l'oggetto BitmapScalingMode per Visual.Gets or sets the BitmapScalingMode for the Visual.

(Ereditato da Visual)
VisualCacheMode

Ottiene o imposta una rappresentazione nascosta dell'oggetto Visual.Gets or sets a cached representation of the Visual.

(Ereditato da Visual)
VisualChildrenCount

Ottiene il numero di elementi figlio per ContainerVisual.Gets the number of children for the ContainerVisual.

VisualClearTypeHint

Ottiene o imposta l'oggetto ClearTypeHint che determina come viene reso ClearType nell'oggetto Visual.Gets or sets the ClearTypeHint that determines how ClearType is rendered in the Visual.

(Ereditato da Visual)
VisualClip

Ottiene o imposta l'area di ridimensionamento dell'oggetto Visual specificato sotto forma di valore Geometry.Gets or sets the clip region of the Visual as a Geometry value.

(Ereditato da Visual)
VisualEdgeMode

Ottiene o imposta la modalità di bordo dell’oggetto Visual sotto forma di valore EdgeMode.Gets or sets the edge mode of the Visual as an EdgeMode value.

(Ereditato da Visual)
VisualEffect

Ottiene o imposta l'effetto bitmap da applicare all'oggetto Visual.Gets or sets the bitmap effect to apply to the Visual.

(Ereditato da Visual)
VisualOffset

Ottiene o imposta il valore di offset dell’oggetto visivo.Gets or sets the offset value of the visual object.

(Ereditato da Visual)
VisualOpacity

Ottiene o imposta l'opacità di Visual.Gets or sets the opacity of the Visual.

(Ereditato da Visual)
VisualOpacityMask

Ottiene o imposta il valore Brush che rappresenta la maschera di opacità dell’oggetto Visual.Gets or sets the Brush value that represents the opacity mask of the Visual.

(Ereditato da Visual)
VisualParent

Ottiene la struttura ad albero padre dell’oggetto visivo.Gets the visual tree parent of the visual object.

(Ereditato da Visual)
VisualScrollableAreaClip

Ottiene o imposta un'area scorrevole ritagliata per l'oggetto Visual.Gets or sets a clipped scrollable area for the Visual.

(Ereditato da Visual)
VisualTextHintingMode

Ottiene o imposta l'oggetto TextHintingMode dell'oggetto Visual.Gets or sets the TextHintingMode of the Visual.

(Ereditato da Visual)
VisualTextRenderingMode

Ottiene o imposta l'oggetto TextRenderingMode dell'oggetto Visual.Gets or sets the TextRenderingMode of the Visual.

(Ereditato da Visual)
VisualTransform

Ottiene o imposta il valore di Transform per Visual.Gets or sets the Transform value for the Visual.

(Ereditato da Visual)
VisualXSnappingGuidelines

Ottiene o imposta la raccolta delle linee guida per la coordinata X (verticale).Gets or sets the x-coordinate (vertical) guideline collection.

(Ereditato da Visual)
VisualYSnappingGuidelines

Ottiene o imposta la raccolta delle linee guida per la coordinata y (orizzontale).Gets or sets the y-coordinate (horizontal) guideline collection.

(Ereditato da Visual)
XSnappingGuidelines

Ottiene o imposta la linea guida X (orizzontale) per ContainerVisual.Gets or sets the X (horizontal) guideline for the ContainerVisual.

YSnappingGuidelines

Ottiene o imposta la linea guida Y (verticale) per ContainerVisual.Gets or sets the Y (vertical) guideline for the ContainerVisual.

Metodi

AddVisualChild(Visual)

Definisce la relazione padre-figlio tra due elementi visivi.Defines the parent-child relationship between two visuals.

(Ereditato da Visual)
CheckAccess()

Determina se il thread chiamante ha accesso a DispatcherObject.Determines whether the calling thread has access to this DispatcherObject.

(Ereditato da DispatcherObject)
ClearValue(DependencyProperty)

Cancella il valore locale di una proprietà.Clears the local value of a property. La proprietà da cancellare è specificata da un identificatore DependencyProperty.The property to be cleared is specified by a DependencyProperty identifier.

(Ereditato da DependencyObject)
ClearValue(DependencyPropertyKey)

Cancella il valore locale di una proprietà di sola lettura.Clears the local value of a read-only property. La proprietà da cancellare è specificata da un oggetto DependencyPropertyKey.The property to be cleared is specified by a DependencyPropertyKey.

(Ereditato da DependencyObject)
CoerceValue(DependencyProperty)

Assegna forzatamente il valore della proprietà di dipendenza specificata.Coerces the value of the specified dependency property. Questa operazione viene eseguita richiamando qualsiasi funzione CoerceValueCallback specificata nei metadati della proprietà di dipendenza esistente nell'oggetto DependencyObject chiamante.This is accomplished by invoking any CoerceValueCallback function specified in property metadata for the dependency property as it exists on the calling DependencyObject.

(Ereditato da DependencyObject)
Equals(Object)

Determina se l'oggetto DependencyObject specificato equivale all'oggetto DependencyObject corrente.Determines whether a provided DependencyObject is equivalent to the current DependencyObject.

(Ereditato da DependencyObject)
FindCommonVisualAncestor(DependencyObject)

Restituisce il predecessore comune di due oggetti visivi.Returns the common ancestor of two visual objects.

(Ereditato da Visual)
GetHashCode()

Ottiene un codice hash per l'oggetto DependencyObject.Gets a hash code for this DependencyObject.

(Ereditato da DependencyObject)
GetLocalValueEnumerator()

Crea un enumeratore specializzato per determinare le proprietà di dipendenza che presentano valori impostati localmente nell'oggetto DependencyObject.Creates a specialized enumerator for determining which dependency properties have locally set values on this DependencyObject.

(Ereditato da DependencyObject)
GetType()

Ottiene l'oggetto Type dell'istanza corrente.Gets the Type of the current instance.

(Ereditato da Object)
GetValue(DependencyProperty)

Restituisce il valore effettivo corrente di una proprietà di dipendenza in questa istanza di DependencyObject.Returns the current effective value of a dependency property on this instance of a DependencyObject.

(Ereditato da DependencyObject)
GetVisualChild(Int32)

Restituisce un oggetto Visual figlio specifico per l'oggetto ContainerVisual padre.Returns a specified child Visual for the parent ContainerVisual.

HitTest(HitTestFilterCallback, HitTestResultCallback, HitTestParameters)

Avvia un hit test su ContainerVisual, usando gli oggetti HitTestFilterCallback e HitTestResultCallback.Initiates a hit test on the ContainerVisual by using the HitTestFilterCallback and HitTestResultCallback objects.

HitTest(Point)

Restituisce l'oggetto visivo in primo piano di un hit test specificando Point.Returns the top-most visual object of a hit test by specifying a Point.

HitTestCore(GeometryHitTestParameters)

Determina se il valore di una geometria si trova all'interno dei limiti dell’oggetto visivo.Determines whether a geometry value is within the bounds of the visual object.

(Ereditato da Visual)
HitTestCore(PointHitTestParameters)

Determina se il valore di coordinata di un punto è all'interno dei limiti dell’oggetto visivo.Determines whether a point coordinate value is within the bounds of the visual object.

(Ereditato da Visual)
InvalidateProperty(DependencyProperty)

Valuta di nuovo il valore effettivo della proprietà di dipendenza specificata.Re-evaluates the effective value for the specified dependency property.

(Ereditato da DependencyObject)
IsAncestorOf(DependencyObject)

Determina se l'oggetto visivo è un predecessore dell'oggetto visivo discendente.Determines whether the visual object is an ancestor of the descendant visual object.

(Ereditato da Visual)
IsDescendantOf(DependencyObject)

Determina se l'oggetto visivo è un discendente dell'oggetto visivo predecessore.Determines whether the visual object is a descendant of the ancestor visual object.

(Ereditato da Visual)
MemberwiseClone()

Crea una copia superficiale dell'oggetto Object corrente.Creates a shallow copy of the current Object.

(Ereditato da Object)
OnDpiChanged(DpiScale, DpiScale)

Chiamato in caso di variazione del valore DPI usato per il rendering della vista.Called when the DPI at which this View is rendered changes.

(Ereditato da Visual)
OnPropertyChanged(DependencyPropertyChangedEventArgs)

Richiamato ogni volta che viene aggiornato il valore effettivo di qualsiasi proprietà di dipendenza in DependencyObject.Invoked whenever the effective value of any dependency property on this DependencyObject has been updated. La proprietà di dipendenza specifica modificata viene indicata nei dati dell'evento.The specific dependency property that changed is reported in the event data.

(Ereditato da DependencyObject)
OnVisualChildrenChanged(DependencyObject, DependencyObject)

Viene chiamato quando l'oggetto VisualCollection dell’oggetto visivo viene modificato.Called when the VisualCollection of the visual object is modified.

(Ereditato da Visual)
OnVisualParentChanged(DependencyObject)

Chiamato quando l’elemento padre dell’oggetto visivo viene modificato.Called when the parent of the visual object is changed.

(Ereditato da Visual)
PointFromScreen(Point)

Converte un oggetto Point sotto forma di coordinate dello schermo in un oggetto Point che rappresenta il sistema di coordinate corrente dell’oggetto Visual.Converts a Point in screen coordinates into a Point that represents the current coordinate system of the Visual.

(Ereditato da Visual)
PointToScreen(Point)

Converte un oggetto Point che rappresenta il sistema di coordinate corrente dell’oggetto Visual in un oggetto Point sotto forma di coordinate dello schermo.Converts a Point that represents the current coordinate system of the Visual into a Point in screen coordinates.

(Ereditato da Visual)
ReadLocalValue(DependencyProperty)

Restituisce il valore locale di una proprietà di dipendenza, se presente.Returns the local value of a dependency property, if it exists.

(Ereditato da DependencyObject)
RemoveVisualChild(Visual)

Rimuove la relazione padre-figlio tra due elementi visivi.Removes the parent-child relationship between two visuals.

(Ereditato da Visual)
SetCurrentValue(DependencyProperty, Object)

Imposta il valore di una proprietà di dipendenza senza modificare l'origine del valore.Sets the value of a dependency property without changing its value source.

(Ereditato da DependencyObject)
SetValue(DependencyProperty, Object)

Imposta il valore locale di una proprietà di dipendenza, specificato dal relativo identificatore della proprietà di dipendenza.Sets the local value of a dependency property, specified by its dependency property identifier.

(Ereditato da DependencyObject)
SetValue(DependencyPropertyKey, Object)

Imposta il valore locale di una proprietà di dipendenza di sola lettura, specificato dall'identificatore DependencyPropertyKey della proprietà di dipendenza.Sets the local value of a read-only dependency property, specified by the DependencyPropertyKey identifier of the dependency property.

(Ereditato da DependencyObject)
ShouldSerializeProperty(DependencyProperty)

Restituisce un valore che indica se i processi di serializzazione devono serializzare il valore della proprietà di dipendenza specificata.Returns a value that indicates whether serialization processes should serialize the value for the provided dependency property.

(Ereditato da DependencyObject)
ToString()

Restituisce una stringa che rappresenta l'oggetto corrente.Returns a string that represents the current object.

(Ereditato da Object)
TransformToAncestor(Visual)

Restituisce una funzione di trasformazione utilizzabile per trasformare le coordinate dall'oggetto Visual al predecessore Visual specificato dell’oggetto visivo.Returns a transform that can be used to transform coordinates from the Visual to the specified Visual ancestor of the visual object.

(Ereditato da Visual)
TransformToAncestor(Visual3D)

Restituisce una funzione di trasformazione utilizzabile per trasformare le coordinate dall'oggetto Visual al predecessore Visual3D specificato dell’oggetto visivo.Returns a transform that can be used to transform coordinates from the Visual to the specified Visual3D ancestor of the visual object.

(Ereditato da Visual)
TransformToDescendant(Visual)

Restituisce una funzione di trasformazione utilizzabile per trasformare le coordinate dall'oggetto Visual al discendente specificato dell’oggetto visivo.Returns a transform that can be used to transform coordinates from the Visual to the specified visual object descendant.

(Ereditato da Visual)
TransformToVisual(Visual)

Restituisce una funzione di trasformazione utilizzabile per trasformare le coordinate dall'oggetto Visual all’oggetto visivo specificato.Returns a transform that can be used to transform coordinates from the Visual to the specified visual object.

(Ereditato da Visual)
VerifyAccess()

Impone che il thread chiamante abbia accesso a DispatcherObject.Enforces that the calling thread has access to this DispatcherObject.

(Ereditato da DispatcherObject)

Si applica a