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

VisualCollection に挿入する Visual。

例外

ArgumentOutOfRangeException

index が 0 未満であるか、Count を超えています。

注釈

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

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

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