VisualCollection VisualCollection VisualCollection VisualCollection Class

Definition

Stellt eine geordnete Auflistung von Visual-Objekten dar.Represents an ordered collection of Visual objects.

public ref class VisualCollection sealed : System::Collections::ICollection
public sealed class VisualCollection : System.Collections.ICollection
type VisualCollection = class
    interface ICollection
    interface IEnumerable
Public NotInheritable Class VisualCollection
Implements ICollection
Vererbung
VisualCollectionVisualCollectionVisualCollectionVisualCollection
Implementiert

Beispiele

Im folgenden Beispiel wird gezeigt, wie Sie VisualCollection einen erstellen und diesem Elemente hinzufügen.The following example shows how to create a VisualCollection and add members to it.

// 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 MyVisualHost : FrameworkElement
{
    // Create a collection of child visual objects.
    private VisualCollection _children;

    public MyVisualHost()
    {
        _children = new VisualCollection(this);
        _children.Add(CreateDrawingVisualRectangle());
        _children.Add(CreateDrawingVisualText());
        _children.Add(CreateDrawingVisualEllipses());

        // Add the event handler for MouseLeftButtonUp.
        this.MouseLeftButtonUp += new System.Windows.Input.MouseButtonEventHandler(MyVisualHost_MouseLeftButtonUp);
    }
' 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 MyVisualHost
    Inherits FrameworkElement
    ' Create a collection of child visual objects.
    Private _children As VisualCollection

    Public Sub New()
        _children = New VisualCollection(Me)
        _children.Add(CreateDrawingVisualRectangle())
        _children.Add(CreateDrawingVisualText())
        _children.Add(CreateDrawingVisualEllipses())

        ' Add the event handler for MouseLeftButtonUp.
        AddHandler MouseLeftButtonUp, AddressOf MyVisualHost_MouseLeftButtonUp
    End Sub

Hinweis

Das komplette Beispiel finden Sie unter Beispiel für Treffer Tests mit DrawingVisuals.For the complete sample, see Hit Test Using DrawingVisuals Sample.

Hinweise

Eine VisualCollection weist eine implizite Kontext Affinität auf.A VisualCollection has implied context affinity. Wenn eine Prozedur versucht, auf die VisualCollection aus einem anderen Kontext als dem Kontext der Besitz ContainerVisualenden zuzugreifen, wird eine Ausnahme ausgelöst.If a procedure attempts to access the VisualCollection from a different context than the context of the owning ContainerVisual, an exception is thrown.

Konstruktoren

VisualCollection(Visual) VisualCollection(Visual) VisualCollection(Visual) VisualCollection(Visual)

Initialisiert eine neue Instanz der VisualCollection-Klasse.Initializes a new instance of the VisualCollection class.

Eigenschaften

Capacity Capacity Capacity Capacity

Ruft die Anzahl der Elemente ab, die die VisualCollection enthalten kann, oder legt diese fest.Gets or sets the number of elements that the VisualCollection can contain.

Count Count Count Count

Ruft die Anzahl der Elemente in der Auflistung ab.Gets the number of elements in the collection.

IsReadOnly IsReadOnly IsReadOnly IsReadOnly

Ruft einen Wert ab, der angibt, ob die VisualCollection schreibgeschützt ist.Gets a value that indicates whether the VisualCollection is read-only.

IsSynchronized IsSynchronized IsSynchronized IsSynchronized

Ruft einen Wert ab, der angibt, ob der Zugriff auf VisualCollection synchronisiert (threadsicher) ist.Gets a value that indicates whether access to the VisualCollection is synchronized (thread-safe).

Item[Int32] Item[Int32] Item[Int32] Item[Int32]

Ruft das am nullbasierten Index der Visual gespeicherte VisualCollection ab oder legt dieses fest.Gets or sets the Visual that is stored at the zero-based index of the VisualCollection.

SyncRoot SyncRoot SyncRoot SyncRoot

Ruft ein Objekt ab, mit dem der Zugriff auf VisualCollection synchronisiert werden kann.Gets an object that can be used to synchronize access to the VisualCollection.

Methoden

Add(Visual) Add(Visual) Add(Visual) Add(Visual)

Fügt ein Visual an das Ende der VisualCollection an.Appends a Visual to the end of the VisualCollection.

Clear() Clear() Clear() Clear()

Entfernt alle Elemente aus der VisualCollection.Removes all elements from the VisualCollection.

Contains(Visual) Contains(Visual) Contains(Visual) Contains(Visual)

Gibt einen Boolean-Wert zurück, der angibt, ob das angegebene Visual in der Auflistung enthalten ist.Returns a Boolean value that indicates whether the specified Visual is contained in the collection.

CopyTo(Array, Int32) CopyTo(Array, Int32) CopyTo(Array, Int32) CopyTo(Array, Int32)

Kopiert die Elemente in der Auflistung ab einem angegebenen Arrayindex in ein Array.Copies the items in the collection to an array, starting at a specific array index.

CopyTo(Visual[], Int32) CopyTo(Visual[], Int32) CopyTo(Visual[], Int32) CopyTo(Visual[], Int32)

Kopiert die aktuelle Auflistung in das übergebene Visual-Array.Copies the current collection into the passed Visual array.

Equals(Object) Equals(Object) Equals(Object) Equals(Object)

Bestimmt, ob das angegebene Objekt mit dem aktuellen Objekt identisch ist.Determines whether the specified object is equal to the current object.

(Inherited from Object)
GetEnumerator() GetEnumerator() GetEnumerator() GetEnumerator()

Ruft einen Enumerator ab, der die VisualCollection durchlaufen kann.Retrieves an enumerator that can iterate through the VisualCollection.

GetHashCode() GetHashCode() GetHashCode() GetHashCode()

Fungiert als Standardhashfunktion.Serves as the default hash function.

(Inherited from Object)
GetType() GetType() GetType() GetType()

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

(Inherited from Object)
IndexOf(Visual) IndexOf(Visual) IndexOf(Visual) IndexOf(Visual)

Gibt den nullbasierten Index des Visual zurück.Returns the zero-based index of the Visual.

Insert(Int32, Visual) Insert(Int32, Visual) Insert(Int32, Visual) Insert(Int32, Visual)

Fügt am angegebenen Index ein Element in die VisualCollection ein.Inserts an element into the VisualCollection at the specified index.

MemberwiseClone() MemberwiseClone() MemberwiseClone() MemberwiseClone()

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

(Inherited from Object)
Remove(Visual) Remove(Visual) Remove(Visual) Remove(Visual)

Entfernt das angegebene Visual-Objekt aus der VisualCollection.Removes the specified Visual object from the VisualCollection.

RemoveAt(Int32) RemoveAt(Int32) RemoveAt(Int32) RemoveAt(Int32)

Entfernt das visuelle Objekt am angegebenen Index in der VisualCollection.Removes the visual object at the specified index in the VisualCollection.

RemoveRange(Int32, Int32) RemoveRange(Int32, Int32) RemoveRange(Int32, Int32) RemoveRange(Int32, Int32)

Entfernt einen Bereich von visuellen Objekten aus der VisualCollection.Removes a range of visual objects from the VisualCollection.

ToString() ToString() ToString() ToString()

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

(Inherited from Object)

Explizite Schnittstellenimplementierungen

IEnumerable.GetEnumerator() IEnumerable.GetEnumerator() IEnumerable.GetEnumerator() IEnumerable.GetEnumerator()

Dieser Member unterstützt die WPFWPF-Infrastruktur und ist nicht für die direkte Verwendung im Code vorgesehen.This member supports the WPFWPF infrastructure and is not intended to be used directly from your code. Eine Beschreibung dieses Elements finden Sie unter GetEnumerator().For a description of this member, see GetEnumerator().

Erweiterungsmethoden

Cast<TResult>(IEnumerable) Cast<TResult>(IEnumerable) Cast<TResult>(IEnumerable) Cast<TResult>(IEnumerable)

Wandelt die Elemente eines IEnumerable in den angegebenen Typ umCasts the elements of an IEnumerable to the specified type.

OfType<TResult>(IEnumerable) OfType<TResult>(IEnumerable) OfType<TResult>(IEnumerable) OfType<TResult>(IEnumerable)

Filtert die Elemente eines IEnumerable anhand eines angegebenen TypsFilters the elements of an IEnumerable based on a specified type.

AsParallel(IEnumerable) AsParallel(IEnumerable) AsParallel(IEnumerable) AsParallel(IEnumerable)

Ermöglicht die Parallelisierung einer Abfrage.Enables parallelization of a query.

AsQueryable(IEnumerable) AsQueryable(IEnumerable) AsQueryable(IEnumerable) AsQueryable(IEnumerable)

Konvertiert einen IEnumerable in einen IQueryable.Converts an IEnumerable to an IQueryable.

Gilt für: