ListView.ListViewItemCollection.Insert メソッド (Int32, String, Int32)

指定したイメージのインデックスを使用して新しい項目を作成し、コレクション内の指定したインデックス位置に挿入します。

Overloads Public Function Insert( _
   ByVal index As Integer, _   ByVal text As String, _   ByVal imageIndex As Integer _) As ListViewItem
[C#]
public ListViewItem Insert(intindex,stringtext,intimageIndex);
[C++]
public: ListViewItem* Insert(intindex,String* text,intimageIndex);
[JScript]
public function Insert(
   index : int,text : String,imageIndex : int) : ListViewItem;

パラメータ

• index
  項目が挿入される位置を示す 0 から始まるインデックス番号。
• text
  項目を示すために表示するテキスト。
• imageIndex
  項目に対して表示するイメージのインデックス。

戻り値

コレクションに挿入された ListViewItem 。

例外

解説

Insert メソッドのこのバージョンを使用すると、新しい項目を ListView.ListViewItemCollection 内の特定の位置に挿入できます。 text パラメータで指定されたテキストを使用して、新しい ListViewItem を作成し、 ListView.ListViewItemCollection の指定した位置に挿入します。また、このバージョンの Insert メソッドを使用して、 ListView.LargeImageList プロパティおよび ListView.SmallImageList プロパティに割り当てられている ImageList のインデックスを imageIndex パラメータに渡すことによって、項目に対して表示するイメージを指定することもできます。通常この 2 つのプロパティは、表示対象の関連するイメージに対して同じインデックス位置を使用します。項目のイメージのインデックスを指定する場合は、文字列をパラメータとして受け入れる、他のバージョンの Insert メソッドを使用します。

コレクションの特定の位置を指定せずに項目を挿入するには、 Add メソッドを使用します。項目の配列をコレクションに追加する場合は、 AddRange メソッドを使用します。

必要条件

プラットフォーム: Windows 98, Windows NT 4.0, Windows Millennium Edition, Windows 2000, Windows XP Home Edition, Windows XP Professional, Windows Server 2003 ファミリ

参照

ListView.ListViewItemCollection クラス | ListView.ListViewItemCollection メンバ | System.Windows.Forms 名前空間 | ListView.ListViewItemCollection.Insert オーバーロードの一覧 | Add | AddRange