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

値を挿入する位置を示す 0 から始まるインデックス。

visual

Visual

Visualに挿入するVisualCollection。

例外

ArgumentOutOfRangeException

index が 0 より小さいか、 Countより大きい。

注釈

Countが既にCapacity等しい場合は、新しいVisualCollectionが挿入される前にVisualの容量が増加します。 indexがCountと等しい場合、visualはVisualCollectionの末尾に追加されます。 index以上の既存のビジュアル オブジェクトは、新しいVisualに合わせてシフトされ、そのインデックス値が更新されます。

Insert メソッドでは、VisualCollectionの所有者である親ビジュアルと子visualの間に親子関係も設定します。

ビジュアル子オブジェクトの基になるストレージ実装をより低レベルで制御する必要がある場合は、 AddVisualChild メソッドと RemoveVisualChild メソッドの使用を検討してください。 これらのメソッドを使用する場合は、独自のストレージ実装を定義し、 VisualCollectionは使用しません。