ContainerVisual Klasse

Definition

Verwaltet eine Auflistung von Visual-Objekten.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
Vererbung
Abgeleitet

Beispiele

Im folgenden Beispiel wird gezeigt, wie ein ContainerVisual-Objekt erstellt wird, das als übergeordnetes Element für zwei DrawingVisual-Objekte verwendet wird.The following example shows how to create a ContainerVisual object that is used as the parent for two DrawingVisual objects. Dem ContainerVisual Objekt hinzugefügte Objekte müssen in umgekehrter z-Reihenfolge (von unten nach oben) hinzugefügt werden, um sicherzustellen, dass Sie in der richtigen Zeichnungsreihenfolge gerendert werden.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. Damit die visuelle Struktur ordnungsgemäß aufgelistet wird, stellt das Beispiel überschriebene Implementierungen der GetVisualChild-Methode und VisualChildrenCount-Eigenschaft bereit.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

Hinweise

Die ContainerVisual-Klasse wird als Container für eine Auflistung von Visual Objekten verwendet.The ContainerVisual class is used as a container for a collection of Visual objects. Die DrawingVisual-Klasse wird von der-Klasse ContainerVisual abgeleitet, sodass die DrawingVisual-Klasse auch eine Auflistung visueller Objekte enthalten kann.The DrawingVisual class derives from the ContainerVisual class, such that the DrawingVisual class can also contain a collection of visual objects.

Konstruktoren

ContainerVisual()

Erstellt eine neue Instanz der ContainerVisual-Klasse.Creates a new instance of the ContainerVisual class.

Eigenschaften

BitmapEffect

Ruft einen BitmapEffect-Wert für das ContainerVisual ab oder legt diesen fest.Gets or sets a BitmapEffect value for the ContainerVisual.

BitmapEffectInput

Ruft einen BitmapEffectInput-Wert für das ContainerVisual ab oder legt diesen fest.Gets or sets a BitmapEffectInput value for the ContainerVisual.

CacheMode

Ruft eine zwischengespeicherte Darstellung des ContainerVisual ab oder legt diese fest.Gets or sets a cached representation of the ContainerVisual.

Children

Ruft die Auflistung der untergeordneten Elemente des ContainerVisual ab.Gets the child collection of the ContainerVisual.

Clip

Ruft den Ausschneidebereich des ContainerVisual ab oder legt diesen fest.Gets or sets the clipping region of the ContainerVisual.

ContentBounds

Ruft das umgebende Feld für den Inhalt des ContainerVisual ab.Gets the bounding box for the contents of the ContainerVisual.

DependencyObjectType

Ruft den DependencyObjectType ab, der den CLRCLR-Typ dieser Instanz umschließt.Gets the DependencyObjectType that wraps the CLRCLR type of this instance.

(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.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

Ruft den Dispatcher ab, der diesem DispatcherObject zugeordnet ist.Gets the Dispatcher this DispatcherObject is associated with.

(Geerbt von DispatcherObject)
Effect

Ruft den Bitmapeffekt ab, der auf das ContainerVisual-Objekt angewendet werden soll, oder legt ihn fest.Gets or sets the bitmap effect to apply to the ContainerVisual.

IsSealed

Ruft einen Wert ab, der angibt, ob diese Instanz derzeit versiegelt (schreibgeschützt) ist.Gets a value that indicates whether this instance is currently sealed (read-only).

(Geerbt von DependencyObject)
Offset

Ruft den Wert für den Offset des ContainerVisual von seinem Bezugspunkt ab oder legt diesen fest.Gets or sets the offset value of the ContainerVisual from its reference point.

Opacity

Ruft die Durchlässigkeit des ContainerVisual ab oder legt diese fest, wobei 0=transparent und 1=undurchlässig ist.Gets or sets the opacity of the ContainerVisual, based on 0=transparent, 1=opaque.

OpacityMask

Ruft einen Pinsel ab, der eine mögliche Durchlässigkeitsmaske für das ContainerVisual angibt, oder legt diesen fest.Gets or sets a brush that specifies a possible opacity mask for the ContainerVisual.

Parent

Ruft das übergeordnete Visual für das ContainerVisual ab.Gets the parent Visual for the ContainerVisual.

Transform

Ruft die auf das ContainerVisual angewendete Transformation ab oder legt diese fest.Gets or sets the transform that is applied to the ContainerVisual.

VisualBitmapEffect

Ruft den BitmapEffect-Wert für das Visual ab oder legt diesen fest.Gets or sets the BitmapEffect value for the Visual.

(Geerbt von Visual)
VisualBitmapEffectInput

Ruft den BitmapEffectInput-Wert für das Visual ab oder legt diesen fest.Gets or sets the BitmapEffectInput value for the Visual.

(Geerbt von Visual)
VisualBitmapScalingMode

Ruft die BitmapScalingMode für den Visual ab oder legt diese fest.Gets or sets the BitmapScalingMode for the Visual.

(Geerbt von Visual)
VisualCacheMode

Ruft eine zwischengespeicherte Darstellung des Visual ab oder legt diese fest.Gets or sets a cached representation of the Visual.

(Geerbt von Visual)
VisualChildrenCount

Ruft die Anzahl der untergeordneten Elemente für das ContainerVisual ab.Gets the number of children for the ContainerVisual.

VisualClearTypeHint

Ruft die ClearTypeHint ab, die bestimmt, wie ClearType im Visual dargestellt wird.Gets or sets the ClearTypeHint that determines how ClearType is rendered in the Visual.

(Geerbt von Visual)
VisualClip

Ruft den Ausschneidebereich des Visual als Geometry-Wert ab oder legt diesen fest.Gets or sets the clip region of the Visual as a Geometry value.

(Geerbt von Visual)
VisualEdgeMode

Ruft den Randmodus des Visual als EdgeMode-Wert ab oder legt diesen fest.Gets or sets the edge mode of the Visual as an EdgeMode value.

(Geerbt von Visual)
VisualEffect

Ruft den Bitmapeffekt ab, der auf das Visual-Objekt angewendet werden soll, oder legt ihn fest.Gets or sets the bitmap effect to apply to the Visual.

(Geerbt von Visual)
VisualOffset

Ruft den Offsetwert des visuellen Objekts ab oder legt diesen fest.Gets or sets the offset value of the visual object.

(Geerbt von Visual)
VisualOpacity

Ruft die Durchlässigkeit des Visual ab oder legt diese fest.Gets or sets the opacity of the Visual.

(Geerbt von Visual)
VisualOpacityMask

Ruft den Brush-Wert ab, der die Durchlässigkeitsmaske des Visual darstellt, oder legt diesen fest.Gets or sets the Brush value that represents the opacity mask of the Visual.

(Geerbt von Visual)
VisualParent

Ruft das übergeordnete visuelle Strukturelement vom visuellen Objekt ab.Gets the visual tree parent of the visual object.

(Geerbt von Visual)
VisualScrollableAreaClip

Ruft einen abgeschnittenen bildlauffähigen Bereich für das Visual-Objekt ab oder legt diesen fest.Gets or sets a clipped scrollable area for the Visual.

(Geerbt von Visual)
VisualTextHintingMode

Ruft den TextHintingMode von Visual ab oder legt ihn fest.Gets or sets the TextHintingMode of the Visual.

(Geerbt von Visual)
VisualTextRenderingMode

Ruft den TextRenderingMode von Visual ab oder legt ihn fest.Gets or sets the TextRenderingMode of the Visual.

(Geerbt von Visual)
VisualTransform

Ruft den Transform-Wert für das Visual ab oder legt diesen fest.Gets or sets the Transform value for the Visual.

(Geerbt von Visual)
VisualXSnappingGuidelines

Ruft die (vertikale) x-Koordinatenführungslinien-Auflistung ab oder legt diese fest.Gets or sets the x-coordinate (vertical) guideline collection.

(Geerbt von Visual)
VisualYSnappingGuidelines

Ruft die (horizontale) y-Koordinatenführungslinien-Auflistung ab oder legt diese fest.Gets or sets the y-coordinate (horizontal) guideline collection.

(Geerbt von Visual)
XSnappingGuidelines

Ruft die (horizontale) X-Führungslinie für ContainerVisual ab oder legt sie fest.Gets or sets the X (horizontal) guideline for the ContainerVisual.

YSnappingGuidelines

Ruft die (vertikale) Y-Führungslinie für ContainerVisual ab oder legt sie fest.Gets or sets the Y (vertical) guideline for the ContainerVisual.

Methoden

AddVisualChild(Visual)

Definiert die hierarchische Beziehung zwischen zwei visuellen Elementen.Defines the parent-child relationship between two visuals.

(Geerbt von Visual)
CheckAccess()

Bestimmt, ob der aufrufende Thread auf dieses DispatcherObject zugreifen kann.Determines whether the calling thread has access to this DispatcherObject.

(Geerbt von DispatcherObject)
ClearValue(DependencyProperty)

Löscht den lokalen Wert einer Eigenschaft.Clears the local value of a property. Die Eigenschaft, deren Wert gelöscht werden soll, wird durch einen DependencyProperty-Bezeichner angegeben.The property to be cleared is specified by a DependencyProperty identifier.

(Geerbt von DependencyObject)
ClearValue(DependencyPropertyKey)

Löscht den lokalen Wert einer schreibgeschützten Eigenschaft.Clears the local value of a read-only property. Die Eigenschaft, deren Wert gelöscht werden soll, wird durch einen DependencyPropertyKey angegeben.The property to be cleared is specified by a DependencyPropertyKey.

(Geerbt von DependencyObject)
CoerceValue(DependencyProperty)

Erzwingt den Wert der angegebenen Abhängigkeitseigenschaft.Coerces the value of the specified dependency property. 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.This is accomplished by invoking any CoerceValueCallback function specified in property metadata for the dependency property as it exists on the calling DependencyObject.

(Geerbt von DependencyObject)
Equals(Object)

Bestimmt, ob ein angegebenes DependencyObject dem aktuellen DependencyObject entspricht.Determines whether a provided DependencyObject is equivalent to the current DependencyObject.

(Geerbt von DependencyObject)
FindCommonVisualAncestor(DependencyObject)

Gibt den gemeinsamen Vorgänger zweier visueller Objekte zurück.Returns the common ancestor of two visual objects.

(Geerbt von Visual)
GetHashCode()

Ruft einen Hashcode für diese DependencyObject ab.Gets a hash code for this DependencyObject.

(Geerbt von DependencyObject)
GetLocalValueEnumerator()

Erstellt einen spezialisierten Enumerator, mit dem bestimmt wird, welche Abhängigkeitseigenschaften dieses DependencyObject über lokal festgelegte Werte verfügen.Creates a specialized enumerator for determining which dependency properties have locally set values on this DependencyObject.

(Geerbt von DependencyObject)
GetType()

Ruft den Type der aktuellen Instanz ab.Gets the Type of the current instance.

(Geerbt von Object)
GetValue(DependencyProperty)

Gibt den aktuellen effektiven Wert einer Abhängigkeitseigenschaft für diese Instanz eines DependencyObject zurück.Returns the current effective value of a dependency property on this instance of a DependencyObject.

(Geerbt von DependencyObject)
GetVisualChild(Int32)

Gibt ein angegebenes untergeordnetes Visual-Element für das übergeordnete ContainerVisual-Element zurück.Returns a specified child Visual for the parent ContainerVisual.

HitTest(HitTestFilterCallback, HitTestResultCallback, HitTestParameters)

Initialisiert einen Treffertest für das ContainerVisual-Objekt, indem das HitTestFilterCallback- und das HitTestResultCallback-Objekt verwendet werden.Initiates a hit test on the ContainerVisual by using the HitTestFilterCallback and HitTestResultCallback objects.

HitTest(Point)

Gibt durch Angeben von Point das oberste visuelle Objekt eines Treffertests zurück.Returns the top-most visual object of a hit test by specifying a Point.

HitTestCore(GeometryHitTestParameters)

Bestimmt, ob sich ein Geometriewert innerhalb der Grenzen des visuellen Objekts befindet.Determines whether a geometry value is within the bounds of the visual object.

(Geerbt von Visual)
HitTestCore(PointHitTestParameters)

Bestimmt, ob sich ein Punktkoordinatenwert innerhalb der Grenzen des visuellen Objekts befindet.Determines whether a point coordinate value is within the bounds of the visual object.

(Geerbt von Visual)
InvalidateProperty(DependencyProperty)

Wertet den effektiven Wert für die angegebene Abhängigkeitseigenschaft erneut aus.Re-evaluates the effective value for the specified dependency property.

(Geerbt von DependencyObject)
IsAncestorOf(DependencyObject)

Bestimmt, ob das visuelle Objekt ein Vorgänger des visuellen Nachfolgerobjekts ist.Determines whether the visual object is an ancestor of the descendant visual object.

(Geerbt von Visual)
IsDescendantOf(DependencyObject)

Bestimmt, ob das visuelle Objekt ein Nachfolger des visuellen Vorgängerobjekts ist.Determines whether the visual object is a descendant of the ancestor visual object.

(Geerbt von Visual)
MemberwiseClone()

Erstellt eine flache Kopie des aktuellen Object.Creates a shallow copy of the current Object.

(Geerbt von Object)
OnDpiChanged(DpiScale, DpiScale)

Wird aufgerufen, wenn sich der DPI-Wert ändert, mit dem diese Ansicht gerendert wird.Called when the DPI at which this View is rendered changes.

(Geerbt von Visual)
OnPropertyChanged(DependencyPropertyChangedEventArgs)

Wird immer dann aufgerufen, wenn der effektive Wert einer Abhängigkeitseigenschaft für dieses DependencyObject aktualisiert wurde.Invoked whenever the effective value of any dependency property on this DependencyObject has been updated. Welche spezifische Abhängigkeitseigenschaft geändert wird, wird in den Ereignisdaten gemeldet.The specific dependency property that changed is reported in the event data.

(Geerbt von DependencyObject)
OnVisualChildrenChanged(DependencyObject, DependencyObject)

Wird aufgerufen, wenn die VisualCollection des visuellen Objekts geändert wurde.Called when the VisualCollection of the visual object is modified.

(Geerbt von Visual)
OnVisualParentChanged(DependencyObject)

Wird aufgerufen, wenn das übergeordnete Element des visuellen Objekts geändert wird.Called when the parent of the visual object is changed.

(Geerbt von Visual)
PointFromScreen(Point)

Konvertiert einen in Bildschirmkoordinaten angegebenen Point in einen Point, der das aktuelle Koordinatensystem des Visual darstellt.Converts a Point in screen coordinates into a Point that represents the current coordinate system of the Visual.

(Geerbt von Visual)
PointToScreen(Point)

Konvertiert einen Point, der das aktuelle Koordinatensystem des Visual darstellt, in einen in Bildschirmkoordinaten angegebenen Point.Converts a Point that represents the current coordinate system of the Visual into a Point in screen coordinates.

(Geerbt von Visual)
ReadLocalValue(DependencyProperty)

Gibt den lokalen Wert einer Abhängigkeitseigenschaft zurück, wenn dieser vorhanden ist.Returns the local value of a dependency property, if it exists.

(Geerbt von DependencyObject)
RemoveVisualChild(Visual)

Entfernt die hierarchische Beziehung zwischen zwei visuellen Elementen.Removes the parent-child relationship between two visuals.

(Geerbt von Visual)
SetCurrentValue(DependencyProperty, Object)

Legt den Wert einer Abhängigkeitseigenschaft fest, ohne deren Wertquelle zu ändern.Sets the value of a dependency property without changing its value source.

(Geerbt von DependencyObject)
SetValue(DependencyProperty, Object)

Legt den lokalen Wert einer Abhängigkeitseigenschaft fest, die durch ihren Bezeichner angegeben ist.Sets the local value of a dependency property, specified by its dependency property identifier.

(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.Sets the local value of a read-only dependency property, specified by the DependencyPropertyKey identifier of the dependency property.

(Geerbt von DependencyObject)
ShouldSerializeProperty(DependencyProperty)

Gibt einen Wert zurück, der angibt, ob Serialisierungsprozesse den Wert der bereitgestellten Abhängigkeitseigenschaft serialisieren sollen.Returns a value that indicates whether serialization processes should serialize the value for the provided dependency property.

(Geerbt von DependencyObject)
ToString()

Gibt eine Zeichenfolge zurück, die das aktuelle Objekt darstellt.Returns a string that represents the current object.

(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.Returns a transform that can be used to transform coordinates from the Visual to the specified Visual ancestor of the visual object.

(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.Returns a transform that can be used to transform coordinates from the Visual to the specified Visual3D ancestor of the visual object.

(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.Returns a transform that can be used to transform coordinates from the Visual to the specified visual object descendant.

(Geerbt von Visual)
TransformToVisual(Visual)

Gibt eine Transformation zurück, mit der Koordinaten des Visual in das angegebene visuelle Objekt transformiert werden können.Returns a transform that can be used to transform coordinates from the Visual to the specified visual object.

(Geerbt von Visual)
VerifyAccess()

Erzwingt, dass der aufrufende Thread auf dieses DispatcherObject zugreifen kann.Enforces that the calling thread has access to this DispatcherObject.

(Geerbt von DispatcherObject)

Gilt für: