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。