VisualCollection.Insert(Int32, Visual) 方法
定義
重要
部分資訊涉及發行前產品,在發行之前可能會有大幅修改。 Microsoft 對此處提供的資訊,不做任何明確或隱含的瑕疵擔保。
將專案插入指定索引處的 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
將 Visual 插入 VisualCollection.
例外狀況
index 小於零或大於 Count。
備註
若Count已等Capacity於 ,則在插入新 VisualCollection 前會增加 的Visual容量。 若 index 等於 Count, visual 則 加到末 VisualCollection尾。 任何等於或大於的 index 現有視覺物件都會被移位以配合新的 Visual,並更新其索引值。
此 Insert 方法同時建立了父視覺化(即 的 VisualCollection擁有者)與子 visual節點之間的父子關係。
如果你需要對視覺子物件底層儲存實作有更深的低階控制,可以考慮使用 AddVisualChild and RemoveVisualChild 方法。 使用這些方法時,你會定義自己的儲存實作,而非使用 VisualCollection。