Insert メソッド (SideButtonCollection)

コレクションの指定したインデックスに、指定したSideButtonBaseを挿入します。

構文

Visual Basic (宣言)
C#

Public Sub Insert( _
   ByVal index As Integer, _
   ByVal item As SideButtonBase _
)

public void Insert( 
   int index,
   SideButtonBase item
)

パラメータ

index: 指定したオブジェクトを挿入する、０から始まるインデックス。
item: 挿入する項目。

例外

例外	解説
System.ArgumentOutOfRangeException	indexパラメーターが0未満か、SideButtonCollectionクラスのCountプロパティの値を超えています。
System.ArgumentException	itemの名前がこのコレクションにすでに存在しています。
System.InvalidOperationException	挿入するitemはすでに別のピッカーコントロールに属しているか、このコレクションにすでに存在しています。

解説

このメソッドを使用すると、ピッカーコントロール内の特定の位置にサイドボタンを挿入できます。コレクション内の特定の位置を指定せずに項目を追加するには、Addメソッドを使用します。サイドボタンの配列をコレクションに追加するには、AddRange(SideButtonBase[])メソッドを使用します。

このメソッドを使用して項目をコレクションに挿入するときに、itemがすでに別のピッカーコントロールに属している場合、またはitemがこのコレクションにすでに存在している場合には、System.InvalidOperationExceptionがスローされます。

プラットフォーム

Target Platforms: Windows 7, Windows Vista SP1 or later, Windows XP SP3, Windows Server 2008 (Server Core not supported), Windows Server 2008 R2 (Server Core supported with SP1 or later), Windows Server 2003 SP2

参照

SideButtonCollection クラス
 SideButtonCollection メンバ
 Add メソッド
 AddRange(SideButtonBase[]) メソッド