Condividi tramite


ContainerVisual Classe

Definizione

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

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)

Si applica a