VisualCollection Třída

Definice

Obor názvů:

System.Windows.Media

Sestavení:

PresentationCore.dll

Představuje uspořádanou kolekci Visual objektů.

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

Dědičnost

Object

VisualCollection

Implementuje

ICollection IEnumerable

Příklady

Následující příklad ukazuje, jak do něj vytvořit VisualCollection a přidat členy.

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

Note

Kompletní ukázku naleznete v části Test hit using DrawingVisuals Sample.

Poznámky

A VisualCollection má implicitní spřažení kontextu. Pokud se procedura pokusí o přístup z VisualCollection jiného kontextu, než je kontext vlastnícího ContainerVisual, vyvolá se výjimka.

Konstruktory

Name	Description
VisualCollection(Visual)	Inicializuje novou instanci VisualCollection třídy.

Vlastnosti

Name	Description
Capacity	Získá nebo nastaví počet prvků, které VisualCollection může obsahovat.
Count	Získá počet prvků v kolekci.
IsReadOnly	Získá hodnotu, která označuje, zda VisualCollection je jen pro čtení.
IsSynchronized	Získá hodnotu, která označuje, zda je přístup k VisualCollection synchronizován (thread-safe).
Item[Int32]	Získá nebo nastaví Visual , který je uložen na nulovém indexu VisualCollection.
SyncRoot	Získá objekt, který lze použít k synchronizaci přístupu k VisualCollection.

Metody

Name	Description
Add(Visual)	Visual Připojí na konec VisualCollection.
Clear()	Odebere všechny prvky z objektu VisualCollection.
Contains(Visual)	Boolean Vrátí hodnotu, která určuje, zda je zadaná Visual hodnota obsažena v kolekci.
CopyTo(Array, Int32)	Zkopíruje položky v kolekci do pole počínaje konkrétním indexem pole.
CopyTo(Visual[], Int32)	Zkopíruje aktuální kolekci do předaného Visual pole.
GetEnumerator()	Načte enumerátor, který může iterovat přes VisualCollection.
IndexOf(Visual)	Vrátí index Visualzaložený na nule .
Insert(Int32, Visual)	Vloží prvek do zadaného indexu VisualCollection .
Remove(Visual)	Odebere zadaný Visual objekt z objektu VisualCollection.
RemoveAt(Int32)	Odebere objekt vizuálu v zadaném indexu v objektu VisualCollection.
RemoveRange(Int32, Int32)	Odebere oblast vizuálních objektů z objektu VisualCollection.

Explicitní implementace rozhraní

Name	Description
IEnumerable.GetEnumerator()	Tento člen podporuje infrastrukturu WPF a nemá být používán přímo z vašeho kódu. Popis tohoto člena naleznete v tématu GetEnumerator().