VisualCollection Класс

Определение

Пространство имен:

System.Windows.Media

Сборка:

PresentationCore.dll

Представляет упорядоченную коллекцию Visual объектов.

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

Наследование

Object

VisualCollection

Реализации

ICollection IEnumerable

Примеры

В следующем примере показано, как создать VisualCollection и добавить в него элементы.

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

Полный пример см. в разделе "Тест попадания с помощью drawingVisuals".

Комментарии

Имеет VisualCollection подразумеваемое сходство контекста. Если процедура пытается получить доступ VisualCollection к другому контексту, отличному от контекста владения ContainerVisual, создается исключение.

Конструкторы

Имя	Описание
VisualCollection(Visual)	Инициализирует новый экземпляр класса VisualCollection.

Свойства

Имя	Описание
Capacity	Возвращает или задает количество элементов, которые VisualCollection могут содержаться.
Count	Возвращает количество элементов в коллекции.
IsReadOnly	Возвращает значение, указывающее, доступен ли доступ VisualCollection только для чтения.
IsSynchronized	Возвращает значение, указывающее, синхронизирован ли доступ к VisualCollection синхронизированному (потокобезопасно).
Item[Int32]	Возвращает или задает объект Visual , хранящийся в отсчитываемом от нуля индексе VisualCollection.
SyncRoot	Получает объект, который можно использовать для синхронизации доступа к объекту VisualCollection.

Методы

Имя	Описание
Add(Visual)	Добавляет к Visual концу VisualCollection.
Clear()	Удаляет все элементы из VisualCollection.
Contains(Visual)	Boolean Возвращает значение, указывающее, содержится ли указанный Visual объект в коллекции.
CopyTo(Array, Int32)	Копирует элементы в коллекцию в массив, начиная с определенного индекса массива.
CopyTo(Visual[], Int32)	Копирует текущую коллекцию в переданный Visual массив.
GetEnumerator()	Извлекает перечислитель, который может выполнять итерацию через VisualCollection.
IndexOf(Visual)	Возвращает отсчитываемый от нуля индекс Visual.
Insert(Int32, Visual)	Вставляет элемент в VisualCollection по указанному индексу.
Remove(Visual)	Удаляет указанный Visual объект из VisualCollectionобъекта.
RemoveAt(Int32)	Удаляет визуальный объект по указанному индексу в элементе VisualCollection.
RemoveRange(Int32, Int32)	Удаляет из него VisualCollectionдиапазон визуальных объектов.

Явные реализации интерфейса

Имя	Описание
IEnumerable.GetEnumerator()	Этот член поддерживает инфраструктуру WPF и не предназначен для использования непосредственно из кода. Описание этого элемента см. в разделе GetEnumerator().