ContainerVisual Classe

Definizione

Spazio dei nomi:

System.Windows.Media

Assembly:

PresentationCore.dll

Gestisce una raccolta di oggetti 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

Ereditarietà

Object

DispatcherObject

DependencyObject

Visual

ContainerVisual

Derivato

System.Windows.Media.DrawingVisual

System.Windows.Media.HostVisual

Esempio

Nell'esempio seguente viene illustrato come creare un ContainerVisual oggetto usato come padre per due DrawingVisual oggetti. Gli oggetti aggiunti all'oggetto devono essere aggiunti in ordine z inverso (in basso all'inizio) per assicurarsi che vengano visualizzati nell'ordine ContainerVisual di disegno corretto. Per enumerare correttamente l'albero visivo, l'esempio fornisce implementazioni ignorate del metodo e VisualChildrenCount della GetVisualChild proprietà.

// 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 ContainerVisual classe viene usata come contenitore per una raccolta di Visual oggetti. La DrawingVisual classe deriva dalla ContainerVisual classe, in modo che la DrawingVisual classe possa contenere anche una raccolta di oggetti visivi.

Costruttori

ContainerVisual()

Crea una nuova istanza della classe ContainerVisual.

Proprietà

BitmapEffect	Obsoleta. Obsoleta. Ottiene o imposta un valore di BitmapEffect per l'oggetto ContainerVisual.
BitmapEffectInput	Obsoleta. Obsoleta. Ottiene o imposta un valore di BitmapEffectInput per l'oggetto ContainerVisual.
CacheMode	Ottiene o imposta una rappresentazione nascosta dell'oggetto ContainerVisual.
Children	Ottiene l'insieme di oggetti figlio dell'oggetto ContainerVisual.
Clip	Ottiene o imposta l'area di ritaglio dell'oggetto ContainerVisual.
ContentBounds	Ottiene il riquadro delimitatore del testo per il contenuto dell'oggetto ContainerVisual.
DependencyObjectType	Ottiene l'oggetto DependencyObjectType che esegue il wrapping del tipo CLR di questa istanza. (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.
Dispatcher	Ottiene l'oggetto Dispatcher associato a DispatcherObject. (Ereditato da DispatcherObject)
Effect	Ottiene o imposta l'effetto bitmap da applicare all'oggetto ContainerVisual.
IsSealed	Ottiene un valore che indica se l'istanza è attualmente sealed (di sola lettura). (Ereditato da DependencyObject)
Offset	Ottiene o imposta il valore di offset dell'oggetto ContainerVisual in base al relativo punto di riferimento.
Opacity	Ottiene o imposta l'opacità dell'oggetto ContainerVisual, in base alle impostazioni 0 = trasparente e 1 = opaco.
OpacityMask	Ottiene o imposta un pennello che specifica una possibile maschera di opacità per l'oggetto ContainerVisual.
Parent	Ottiene l'oggetto Visual padre dell'oggetto ContainerVisual.
Transform	Ottiene o imposta la trasformazione applicata all'oggetto ContainerVisual.
VisualBitmapEffect	Obsoleta. Obsoleta. Ottiene o imposta il valore di BitmapEffect per Visual. (Ereditato da Visual)
VisualBitmapEffectInput	Obsoleta. Obsoleta. Ottiene o imposta il valore di BitmapEffectInput per Visual. (Ereditato da Visual)
VisualBitmapScalingMode	Ottiene o imposta l'oggetto BitmapScalingMode per Visual. (Ereditato da Visual)
VisualCacheMode	Ottiene o imposta una rappresentazione nascosta dell'oggetto Visual. (Ereditato da Visual)
VisualChildrenCount	Ottiene il numero di elementi figlio per ContainerVisual.
VisualClearTypeHint	Ottiene o imposta l'oggetto ClearTypeHint che determina come viene reso ClearType nell'oggetto Visual. (Ereditato da Visual)
VisualClip	Ottiene o imposta l'area di ridimensionamento dell'oggetto Visual specificato sotto forma di valore Geometry. (Ereditato da Visual)
VisualEdgeMode	Ottiene o imposta la modalità di bordo dell’oggetto Visual sotto forma di valore EdgeMode. (Ereditato da Visual)
VisualEffect	Ottiene o imposta l'effetto bitmap da applicare all'oggetto Visual. (Ereditato da Visual)
VisualOffset	Ottiene o imposta il valore di offset dell’oggetto visivo. (Ereditato da Visual)
VisualOpacity	Ottiene o imposta l'opacità di Visual. (Ereditato da Visual)
VisualOpacityMask	Ottiene o imposta il valore Brush che rappresenta la maschera di opacità dell’oggetto Visual. (Ereditato da Visual)
VisualParent	Ottiene la struttura ad albero padre dell’oggetto visivo. (Ereditato da Visual)
VisualScrollableAreaClip	Ottiene o imposta un'area scorrevole ritagliata per l'oggetto Visual. (Ereditato da Visual)
VisualTextHintingMode	Ottiene o imposta l'oggetto TextHintingMode di Visual. (Ereditato da Visual)
VisualTextRenderingMode	Ottiene o imposta l'oggetto TextRenderingMode di Visual. (Ereditato da Visual)
VisualTransform	Ottiene o imposta il valore di Transform per Visual. (Ereditato da Visual)
VisualXSnappingGuidelines	Ottiene o imposta la raccolta delle linee guida per la coordinata X (verticale). (Ereditato da Visual)
VisualYSnappingGuidelines	Ottiene o imposta la raccolta delle linee guida per la coordinata y (orizzontale). (Ereditato da Visual)
XSnappingGuidelines	Ottiene o imposta la linea guida X (orizzontale) per ContainerVisual.
YSnappingGuidelines	Ottiene o imposta la linea guida Y (verticale) per ContainerVisual.

Metodi

AddVisualChild(Visual)	Definisce la relazione padre-figlio tra due elementi visivi. (Ereditato da Visual)
CheckAccess()	Determina se il thread chiamante ha accesso a DispatcherObject. (Ereditato da DispatcherObject)
ClearValue(DependencyProperty)	Cancella il valore locale di una proprietà. La proprietà da cancellare è specificata da un identificatore DependencyProperty. (Ereditato da DependencyObject)
ClearValue(DependencyPropertyKey)	Cancella il valore locale di una proprietà di sola lettura. La proprietà da cancellare è specificata da un oggetto DependencyPropertyKey. (Ereditato da DependencyObject)
CoerceValue(DependencyProperty)	Assegna forzatamente il valore della proprietà di dipendenza specificata. Questa operazione viene eseguita richiamando qualsiasi funzione CoerceValueCallback specificata nei metadati della proprietà di dipendenza esistente nell'oggetto DependencyObject chiamante. (Ereditato da DependencyObject)
Equals(Object)	Determina se l'oggetto DependencyObject specificato equivale all'oggetto DependencyObject corrente. (Ereditato da DependencyObject)
FindCommonVisualAncestor(DependencyObject)	Restituisce il predecessore comune di due oggetti visivi. (Ereditato da Visual)
GetHashCode()	Ottiene un codice hash per l'oggetto DependencyObject. (Ereditato da DependencyObject)
GetLocalValueEnumerator()	Crea un enumeratore specializzato per determinare le proprietà di dipendenza che presentano valori impostati localmente nell'oggetto DependencyObject. (Ereditato da DependencyObject)
GetType()	Ottiene l'oggetto Type dell'istanza corrente. (Ereditato da Object)
GetValue(DependencyProperty)	Restituisce il valore effettivo corrente di una proprietà di dipendenza in questa istanza di DependencyObject. (Ereditato da DependencyObject)
GetVisualChild(Int32)	Restituisce un oggetto Visual figlio specifico per l'oggetto ContainerVisual padre.
HitTest(HitTestFilterCallback, HitTestResultCallback, HitTestParameters)	Avvia un hit test su ContainerVisual, usando gli oggetti HitTestFilterCallback e HitTestResultCallback.
HitTest(Point)	Restituisce l'oggetto visivo in primo piano di un hit test specificando Point.
HitTestCore(GeometryHitTestParameters)	Determina se il valore di una geometria si trova all'interno dei limiti dell’oggetto visivo. (Ereditato da Visual)
HitTestCore(PointHitTestParameters)	Determina se il valore di coordinata di un punto è all'interno dei limiti dell’oggetto visivo. (Ereditato da Visual)
InvalidateProperty(DependencyProperty)	Valuta di nuovo il valore effettivo della proprietà di dipendenza specificata. (Ereditato da DependencyObject)
IsAncestorOf(DependencyObject)	Determina se l'oggetto visivo è un predecessore dell'oggetto visivo discendente. (Ereditato da Visual)
IsDescendantOf(DependencyObject)	Determina se l'oggetto visivo è un discendente dell'oggetto visivo predecessore. (Ereditato da Visual)
MemberwiseClone()	Crea una copia superficiale dell'oggetto Object corrente. (Ereditato da Object)
OnDpiChanged(DpiScale, DpiScale)	Chiamato in caso di variazione del valore DPI usato per il rendering della vista. (Ereditato da Visual)
OnPropertyChanged(DependencyPropertyChangedEventArgs)	Richiamato ogni volta che viene aggiornato il valore effettivo di qualsiasi proprietà di dipendenza in DependencyObject. La proprietà di dipendenza specifica modificata viene indicata nei dati dell'evento. (Ereditato da DependencyObject)
OnVisualChildrenChanged(DependencyObject, DependencyObject)	Viene chiamato quando l'oggetto VisualCollection dell’oggetto visivo viene modificato. (Ereditato da Visual)
OnVisualParentChanged(DependencyObject)	Chiamato quando l’elemento padre dell’oggetto visivo viene modificato. (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. (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. (Ereditato da Visual)
ReadLocalValue(DependencyProperty)	Restituisce il valore locale di una proprietà di dipendenza, se esistente. (Ereditato da DependencyObject)
RemoveVisualChild(Visual)	Rimuove la relazione padre-figlio tra due elementi visivi. (Ereditato da Visual)
SetCurrentValue(DependencyProperty, Object)	Imposta il valore di una proprietà di dipendenza senza modificare l'origine del valore. (Ereditato da DependencyObject)
SetValue(DependencyProperty, Object)	Imposta il valore locale di una proprietà di dipendenza, specificato dal relativo identificatore della proprietà di dipendenza. (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. (Ereditato da DependencyObject)
ShouldSerializeProperty(DependencyProperty)	Restituisce un valore che indica se i processi di serializzazione devono serializzare il valore della proprietà di dipendenza specificata. (Ereditato da DependencyObject)
ToString()	Restituisce una stringa che rappresenta l'oggetto corrente. (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. (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. (Ereditato da Visual)
TransformToDescendant(Visual)	Restituisce una funzione di trasformazione utilizzabile per trasformare le coordinate dall'oggetto Visual al discendente specificato dell’oggetto visivo. (Ereditato da Visual)
TransformToVisual(Visual)	Restituisce una funzione di trasformazione utilizzabile per trasformare le coordinate dall'oggetto Visual all’oggetto visivo specificato. (Ereditato da Visual)
VerifyAccess()	Impone che il thread chiamante abbia accesso a DispatcherObject. (Ereditato da DispatcherObject)