ContainerVisual Klasse

Referenz

Definition

Namespace:: System.Windows.Media

Assembly:: PresentationCore.dll

Wichtig

Einige Informationen beziehen sich auf Vorabversionen, die vor dem Release ggf. grundlegend überarbeitet werden. Microsoft übernimmt hinsichtlich der hier bereitgestellten Informationen keine Gewährleistungen, seien sie ausdrücklich oder konkludent.

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: Object

DispatcherObject

DependencyObject

Visual
ContainerVisual

Abgeleitet: System.Windows.Media.DrawingVisual

System.Windows.Media.HostVisual

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:

Freigeben über