VisualCollection.Insert(Int32, Visual) 方法

定義

命名空間:

System.Windows.Media

組件:

PresentationCore.dll

將項目插入至 VisualCollection 中指定的索引位置。

public:
 void Insert(int index, System::Windows::Media::Visual ^ visual);

public void Insert (int index, System.Windows.Media.Visual visual);

member this.Insert : int * System.Windows.Media.Visual -> unit

Public Sub Insert (index As Integer, visual As Visual)

參數

index

Int32

應該插入值之以零起始的索引。

visual

Visual

要插入 VisualCollection 的 Visual。

例外狀況

ArgumentOutOfRangeException

index 小於零或大於 Count。

備註

如果 Count 已經等於 Capacity ，則會在插入新的 Visual 之前增加 的 VisualCollection 容量。 如果 index 等於 Count ， visual 則會新增至 的 VisualCollection 結尾。 任何等於或大於 index 的現有視覺物件都會移位以容納新的 Visual ，並更新其索引值。

方法 Insert 也會設定父視覺效果之間的父子關聯性，也就是 的擁有者和 VisualCollection 子 visual 系 。

如果您需要對視覺子物件的基礎儲存實作進行更高的低階控制，請考慮使用 AddVisualChild 和 RemoveVisualChild 方法。 當您使用這些方法時，您會定義自己的儲存體實作，而且不使用 VisualCollection 。