次の方法で共有


VisualCollection.Insert(Int32, Visual) メソッド

定義

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

例外

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

注釈

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

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

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

適用対象