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 -> unitPublic Sub Insert (index As Integer, visual As Visual)パラメーター
- index
- Int32
値を挿入する位置の、0 から始まるインデックス。
- visual
- Visual
VisualCollection に挿入する Visual。
例外
index が 0 未満であるか、Count を超えています。
注釈
既にCapacity等しい場合Countは、新規Visualが挿入される前に、その容量VisualCollectionが増加します。 と等しいCount場合indexは、 visual のVisualCollection末尾に追加されます。 次の値以上 index の既存のビジュアル オブジェクトは、新しい Visualビジュアル オブジェクトに合わせてシフトされ、そのインデックス値が更新されます。
また、このメソッドはInsert、親ビジュアルの所有者である親ビジュアルと子visualビジュアルの間のVisualCollection親子関係も設定します。
ビジュアル子オブジェクトの基になるストレージ実装をより低レベルで制御する必要がある場合は、and RemoveVisualChild メソッドの使用をAddVisualChild検討してください。 これらのメソッドを使用する場合は、独自のストレージ実装を定義し、使用しません VisualCollection。