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

注释

有关完整示例，请参阅 使用 DrawingVisuals 示例进行命中测试。

注解

具有 VisualCollection 隐式上下文相关性。 如果过程尝试从与拥有VisualCollection上下文不同的上下文访问ContainerVisual，则会引发异常。

构造函数

名称	说明
VisualCollection(Visual)	初始化 VisualCollection 类的新实例。

属性

名称	说明
Capacity	获取或设置可包含的元素 VisualCollection 数。
Count	获取集合中的元素数。
IsReadOnly	获取一个值，该值指示是否 VisualCollection 为只读。
IsSynchronized	获取一个值，该值指示对 VisualCollection 同步的访问是否同步（线程安全）。
Item[Int32]	获取或设置 Visual 存储在从零开始的索引处的 VisualCollection。
SyncRoot	获取可用于同步对 . VisualCollection的访问的对象。

方法

名称	说明
Add(Visual)	将 a 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()。