Teilen über


ContainerVisual Klasse

Definition

Verwaltet eine Auflistung von Visual-Objekten.

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
Vererbung
Abgeleitet

Beispiele

Das folgende Beispiel zeigt, wie Sie ein ContainerVisual -Objekt erstellen, das als übergeordnetes Objekt für zwei DrawingVisual -Objekte verwendet wird. Objekte, die dem ContainerVisual Objekt hinzugefügt werden, müssen in umgekehrter Z-Reihenfolge (von unten nach oben) hinzugefügt werden, um sicherzustellen, dass sie in der richtigen Zeichnungsreihenfolge gerendert werden. Damit die visuelle Struktur ordnungsgemäß aufgezählt wird, werden im Beispiel überschriebene Implementierungen der -Methode und VisualChildrenCount -GetVisualChildEigenschaft bereitgestellt.

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

Hinweise

Die ContainerVisual-Klasse wird als Container für eine Auflistung von Visual-Objekten verwendet. Die DrawingVisual -Klasse wird von der ContainerVisual -Klasse abgeleitet, sodass die DrawingVisual Klasse auch eine Auflistung von visuellen Objekten enthalten kann.

Konstruktoren

ContainerVisual()

Erstellt eine neue Instanz der ContainerVisual-Klasse.

Eigenschaften

BitmapEffect
Veraltet.
Veraltet.

Ruft einen BitmapEffect-Wert für das ContainerVisual ab oder legt diesen fest.

BitmapEffectInput
Veraltet.
Veraltet.

Ruft einen BitmapEffectInput-Wert für das ContainerVisual ab oder legt diesen fest.

CacheMode

Ruft eine zwischengespeicherte Darstellung des ContainerVisual ab oder legt diese fest.

Children

Ruft die Auflistung der untergeordneten Elemente des ContainerVisual ab.

Clip

Ruft den Ausschneidebereich des ContainerVisual ab oder legt diesen fest.

ContentBounds

Ruft das umgebende Feld für den Inhalt des ContainerVisual ab.

DependencyObjectType

Ruft den ab, der DependencyObjectType den CLR-Typ dieser Instanz umschließt.

(Geerbt von DependencyObject)
DescendantBounds

Ruft die Gesamtmenge aller umgebenden Felder des Inhalts für alle Nachfolgerelemente des ContainerVisual ab, doch ohne das umgebende Feld für den Inhalt des ContainerVisual.

Dispatcher

Ruft den Dispatcher ab, der diesem DispatcherObject zugeordnet ist.

(Geerbt von DispatcherObject)
Effect

Ruft den Bitmapeffekt ab, der auf das ContainerVisual-Objekt angewendet werden soll, oder legt ihn fest.

IsSealed

Ruft einen Wert ab, der angibt, ob diese Instanz derzeit versiegelt (schreibgeschützt) ist.

(Geerbt von DependencyObject)
Offset

Ruft den Wert für den Offset des ContainerVisual von seinem Bezugspunkt ab oder legt diesen fest.

Opacity

Ruft die Durchlässigkeit des ContainerVisual ab oder legt diese fest, wobei 0=transparent und 1=undurchlässig ist.

OpacityMask

Ruft einen Pinsel ab, der eine mögliche Durchlässigkeitsmaske für das ContainerVisual angibt, oder legt diesen fest.

Parent

Ruft das übergeordnete Visual für das ContainerVisual ab.

Transform

Ruft die auf das ContainerVisual angewendete Transformation ab oder legt diese fest.

VisualBitmapEffect
Veraltet.
Veraltet.

Ruft den BitmapEffect-Wert für das Visual ab oder legt diesen fest.

(Geerbt von Visual)
VisualBitmapEffectInput
Veraltet.
Veraltet.

Ruft den BitmapEffectInput-Wert für das Visual ab oder legt diesen fest.

(Geerbt von Visual)
VisualBitmapScalingMode

Ruft die BitmapScalingMode für den Visual ab oder legt diese fest.

(Geerbt von Visual)
VisualCacheMode

Ruft eine zwischengespeicherte Darstellung des Visual ab oder legt diese fest.

(Geerbt von Visual)
VisualChildrenCount

Ruft die Anzahl der untergeordneten Elemente für das ContainerVisual ab.

VisualClearTypeHint

Ruft die ClearTypeHint ab, die bestimmt, wie ClearType im Visual dargestellt wird.

(Geerbt von Visual)
VisualClip

Ruft den Ausschneidebereich des Visual als Geometry-Wert ab oder legt diesen fest.

(Geerbt von Visual)
VisualEdgeMode

Ruft den Randmodus des Visual als EdgeMode-Wert ab oder legt diesen fest.

(Geerbt von Visual)
VisualEffect

Ruft den Bitmapeffekt ab, der auf das Visual-Objekt angewendet werden soll, oder legt ihn fest.

(Geerbt von Visual)
VisualOffset

Ruft den Offsetwert des visuellen Objekts ab oder legt diesen fest.

(Geerbt von Visual)
VisualOpacity

Ruft die Durchlässigkeit des Visual ab oder legt diese fest.

(Geerbt von Visual)
VisualOpacityMask

Ruft den Brush-Wert ab, der die Durchlässigkeitsmaske des Visual darstellt, oder legt diesen fest.

(Geerbt von Visual)
VisualParent

Ruft das übergeordnete visuelle Strukturelement vom visuellen Objekt ab.

(Geerbt von Visual)
VisualScrollableAreaClip

Ruft einen abgeschnittenen bildlauffähigen Bereich für das Visual-Objekt ab oder legt diesen fest.

(Geerbt von Visual)
VisualTextHintingMode

Ruft den TextHintingMode von Visual ab oder legt ihn fest.

(Geerbt von Visual)
VisualTextRenderingMode

Ruft den TextRenderingMode von Visual ab oder legt ihn fest.

(Geerbt von Visual)
VisualTransform

Ruft den Transform-Wert für das Visual ab oder legt diesen fest.

(Geerbt von Visual)
VisualXSnappingGuidelines

Ruft die (vertikale) x-Koordinatenführungslinien-Auflistung ab oder legt diese fest.

(Geerbt von Visual)
VisualYSnappingGuidelines

Ruft die (horizontale) y-Koordinatenführungslinien-Auflistung ab oder legt diese fest.

(Geerbt von Visual)
XSnappingGuidelines

Ruft die (horizontale) X-Führungslinie für ContainerVisual ab oder legt sie fest.

YSnappingGuidelines

Ruft die (vertikale) Y-Führungslinie für ContainerVisual ab oder legt sie fest.

Methoden

AddVisualChild(Visual)

Definiert die hierarchische Beziehung zwischen zwei visuellen Elementen.

(Geerbt von Visual)
CheckAccess()

Bestimmt, ob der aufrufende Thread auf dieses DispatcherObject zugreifen kann.

(Geerbt von DispatcherObject)
ClearValue(DependencyProperty)

Löscht den lokalen Wert einer Eigenschaft. Die Eigenschaft, deren Wert gelöscht werden soll, wird durch einen DependencyProperty-Bezeichner angegeben.

(Geerbt von DependencyObject)
ClearValue(DependencyPropertyKey)

Löscht den lokalen Wert einer schreibgeschützten Eigenschaft. Die Eigenschaft, deren Wert gelöscht werden soll, wird durch einen DependencyPropertyKey angegeben.

(Geerbt von DependencyObject)
CoerceValue(DependencyProperty)

Erzwingt den Wert der angegebenen Abhängigkeitseigenschaft. Dies erfolgt durch den Aufruf einer beliebigen CoerceValueCallback-Funktion, die in den Metadaten für die Abhängigkeitseigenschaft angegeben ist, während sie beim aufrufenden DependencyObject beendet wird.

(Geerbt von DependencyObject)
Equals(Object)

Bestimmt, ob ein angegebenes DependencyObject dem aktuellen DependencyObject entspricht.

(Geerbt von DependencyObject)
FindCommonVisualAncestor(DependencyObject)

Gibt den gemeinsamen Vorgänger zweier visueller Objekte zurück.

(Geerbt von Visual)
GetHashCode()

Ruft einen Hashcode für diese DependencyObject ab.

(Geerbt von DependencyObject)
GetLocalValueEnumerator()

Erstellt einen spezialisierten Enumerator, mit dem bestimmt wird, welche Abhängigkeitseigenschaften dieses DependencyObject über lokal festgelegte Werte verfügen.

(Geerbt von DependencyObject)
GetType()

Ruft den Type der aktuellen Instanz ab.

(Geerbt von Object)
GetValue(DependencyProperty)

Gibt den aktuellen effektiven Wert einer Abhängigkeitseigenschaft für diese Instanz eines DependencyObject zurück.

(Geerbt von DependencyObject)
GetVisualChild(Int32)

Gibt ein angegebenes untergeordnetes Visual-Element für das übergeordnete ContainerVisual-Element zurück.

HitTest(HitTestFilterCallback, HitTestResultCallback, HitTestParameters)

Initialisiert einen Treffertest für das ContainerVisual-Objekt, indem das HitTestFilterCallback- und das HitTestResultCallback-Objekt verwendet werden.

HitTest(Point)

Gibt durch Angeben von Point das oberste visuelle Objekt eines Treffertests zurück.

HitTestCore(GeometryHitTestParameters)

Bestimmt, ob sich ein Geometriewert innerhalb der Grenzen des visuellen Objekts befindet.

(Geerbt von Visual)
HitTestCore(PointHitTestParameters)

Bestimmt, ob sich ein Punktkoordinatenwert innerhalb der Grenzen des visuellen Objekts befindet.

(Geerbt von Visual)
InvalidateProperty(DependencyProperty)

Wertet den effektiven Wert für die angegebene Abhängigkeitseigenschaft erneut aus.

(Geerbt von DependencyObject)
IsAncestorOf(DependencyObject)

Bestimmt, ob das visuelle Objekt ein Vorgänger des visuellen Nachfolgerobjekts ist.

(Geerbt von Visual)
IsDescendantOf(DependencyObject)

Bestimmt, ob das visuelle Objekt ein Nachfolger des visuellen Vorgängerobjekts ist.

(Geerbt von Visual)
MemberwiseClone()

Erstellt eine flache Kopie des aktuellen Object.

(Geerbt von Object)
OnDpiChanged(DpiScale, DpiScale)

Wird aufgerufen, wenn sich der DPI-Wert ändert, mit dem diese Ansicht gerendert wird.

(Geerbt von Visual)
OnPropertyChanged(DependencyPropertyChangedEventArgs)

Wird immer dann aufgerufen, wenn der effektive Wert einer Abhängigkeitseigenschaft für dieses DependencyObject aktualisiert wurde. Welche spezifische Abhängigkeitseigenschaft geändert wird, wird in den Ereignisdaten gemeldet.

(Geerbt von DependencyObject)
OnVisualChildrenChanged(DependencyObject, DependencyObject)

Wird aufgerufen, wenn die VisualCollection des visuellen Objekts geändert wurde.

(Geerbt von Visual)
OnVisualParentChanged(DependencyObject)

Wird aufgerufen, wenn das übergeordnete Element des visuellen Objekts geändert wird.

(Geerbt von Visual)
PointFromScreen(Point)

Konvertiert einen in Bildschirmkoordinaten angegebenen Point in einen Point, der das aktuelle Koordinatensystem des Visual darstellt.

(Geerbt von Visual)
PointToScreen(Point)

Konvertiert einen Point, der das aktuelle Koordinatensystem des Visual darstellt, in einen in Bildschirmkoordinaten angegebenen Point.

(Geerbt von Visual)
ReadLocalValue(DependencyProperty)

Gibt den lokalen Wert einer Abhängigkeitseigenschaft zurück, wenn dieser vorhanden ist.

(Geerbt von DependencyObject)
RemoveVisualChild(Visual)

Entfernt die hierarchische Beziehung zwischen zwei visuellen Elementen.

(Geerbt von Visual)
SetCurrentValue(DependencyProperty, Object)

Legt den Wert einer Abhängigkeitseigenschaft fest, ohne deren Wertquelle zu ändern.

(Geerbt von DependencyObject)
SetValue(DependencyProperty, Object)

Legt den lokalen Wert einer Abhängigkeitseigenschaft fest, die durch ihren Bezeichner angegeben ist.

(Geerbt von DependencyObject)
SetValue(DependencyPropertyKey, Object)

Legt den lokalen Wert einer schreibgeschützten Abhängigkeitseigenschaft fest, die durch den DependencyPropertyKey-Bezeichner der Abhängigkeitseigenschaft angegeben ist.

(Geerbt von DependencyObject)
ShouldSerializeProperty(DependencyProperty)

Gibt einen Wert zurück, der angibt, ob Serialisierungsprozesse den Wert der bereitgestellten Abhängigkeitseigenschaft serialisieren sollen.

(Geerbt von DependencyObject)
ToString()

Gibt eine Zeichenfolge zurück, die das aktuelle Objekt darstellt.

(Geerbt von Object)
TransformToAncestor(Visual)

Gibt eine Transformation zurück, mit der Koordinaten des Visual in den Visual-Vorgänger des visuellen Objekts transformiert werden können.

(Geerbt von Visual)
TransformToAncestor(Visual3D)

Gibt eine Transformation zurück, mit der Koordinaten des Visual in den Visual3D-Vorgänger des visuellen Objekts transformiert werden können.

(Geerbt von Visual)
TransformToDescendant(Visual)

Gibt eine Transformation zurück, mit der Koordinaten des Visual in den angegebenen Nachfolger des visuellen Objekts transformiert werden können.

(Geerbt von Visual)
TransformToVisual(Visual)

Gibt eine Transformation zurück, mit der Koordinaten des Visual in das angegebene visuelle Objekt transformiert werden können.

(Geerbt von Visual)
VerifyAccess()

Erzwingt, dass der aufrufende Thread auf dieses DispatcherObject zugreifen kann.

(Geerbt von DispatcherObject)

Gilt für: