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具有隱含的內容親和性。 如果程式嘗試從與擁有 ContainerVisual 內容不同的內容存取 VisualCollection ，則會擲回例外狀況。

建構函式

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 陣列。
Equals(Object)	判斷指定的物件是否等於目前的物件。 (繼承來源 Object)
GetEnumerator()	擷取可以逐一查看 VisualCollection 的列舉值。
GetHashCode()	做為預設雜湊函式。 (繼承來源 Object)
GetType()	取得目前執行個體的 Type。 (繼承來源 Object)
IndexOf(Visual)	傳回 Visual 的以零起始的索引。
Insert(Int32, Visual)	將項目插入至 VisualCollection 中指定的索引位置。
MemberwiseClone()	建立目前 Object 的淺層複製。 (繼承來源 Object)
Remove(Visual)	從 Visual 移除指定的 VisualCollection 物件。
RemoveAt(Int32)	移除 VisualCollection 中所指定索引處的視覺物件。
RemoveRange(Int32, Int32)	從 VisualCollection 移除某範圍的視覺物件。
ToString()	傳回代表目前物件的字串。 (繼承來源 Object)

明確介面實作

IEnumerable.GetEnumerator()

此成員支援 WPF 基礎結構，不適合直接從您的程式碼使用。 如需這個成員的說明，請參閱 GetEnumerator()。

擴充方法

Cast<TResult>(IEnumerable)	將 IEnumerable 的項目轉換成指定的型別。
OfType<TResult>(IEnumerable)	根據指定的型別來篩選 IEnumerable 的項目。
AsParallel(IEnumerable)	啟用查詢的平行化作業。
AsQueryable(IEnumerable)	將 IEnumerable 轉換成 IQueryable。