ListView.ListViewItemCollection.Insert メソッド

定義

名前空間:

System.Windows.Forms

アセンブリ:

System.Windows.Forms.dll

指定したインデックス位置にあるコレクションに項目を挿入します。

オーバーロード

名前	説明
Insert(Int32, String, String, String)	指定したキー、テキスト、およびイメージを持つ新しい項目を作成し、指定したインデックス位置にあるコレクションに追加します。
Insert(Int32, String, String, Int32)	指定したキー、テキスト、およびイメージを持つ新しい項目を作成し、コレクション内の指定したインデックス位置に挿入します。
Insert(Int32, String, String)	指定したテキストと画像を含む新しい項目を作成し、コレクション内の指定したインデックス位置に挿入します。
Insert(Int32, ListViewItem)	指定したインデックス位置にあるコレクションに既存の ListViewItem を挿入します。
Insert(Int32, String)	新しい項目を作成し、コレクション内の指定したインデックス位置に挿入します。
Insert(Int32, String, Int32)	指定したイメージ インデックスを持つ新しい項目を作成し、指定したインデックス位置にあるコレクションに挿入します。

Insert(Int32, String, String, String)

ソース:

ListView.ListViewItemCollection.cs

指定したキー、テキスト、およびイメージを持つ新しい項目を作成し、指定したインデックス位置にあるコレクションに追加します。

public:
 virtual System::Windows::Forms::ListViewItem ^ Insert(int index, System::String ^ key, System::String ^ text, System::String ^ imageKey);

public virtual System.Windows.Forms.ListViewItem Insert(int index, string? key, string? text, string? imageKey);

abstract member Insert : int * string * string * string -> System.Windows.Forms.ListViewItem
override this.Insert : int * string * string * string -> System.Windows.Forms.ListViewItem

Public Overridable Function Insert (index As Integer, key As String, text As String, imageKey As String) As ListViewItem

パラメーター

index

Int32

項目が挿入される 0 から始まるインデックス位置。

key

String

アイテムの Name 。

text

String

アイテムのテキスト。

imageKey

String

アイテムに表示するイメージのキー。

戻り値

ListViewItem

ListViewItemコレクションに追加されます。

例外

ArgumentOutOfRangeException

index パラメーターが 0 未満であるか、ListView.ListViewItemCollectionの Count プロパティの値より大きい値です。

注釈

Insert メソッドは、アイテムのName プロパティを指定したキーに設定し、インデックスまたはキーでアイテムを取得できるようにします。

Insert(Int32, String, String, Int32)

ソース:

ListView.ListViewItemCollection.cs

指定したキー、テキスト、およびイメージを持つ新しい項目を作成し、コレクション内の指定したインデックス位置に挿入します。

public:
 virtual System::Windows::Forms::ListViewItem ^ Insert(int index, System::String ^ key, System::String ^ text, int imageIndex);

public virtual System.Windows.Forms.ListViewItem Insert(int index, string? key, string? text, int imageIndex);

abstract member Insert : int * string * string * int -> System.Windows.Forms.ListViewItem
override this.Insert : int * string * string * int -> System.Windows.Forms.ListViewItem

Public Overridable Function Insert (index As Integer, key As String, text As String, imageIndex As Integer) As ListViewItem

パラメーター

index

Int32

項目が挿入される 0 から始まるインデックス位置。

key

String

アイテムの Name 。

text

String

アイテムのテキスト。

imageIndex

Int32

アイテムに表示するイメージのインデックス。

戻り値

ListViewItem

ListViewItemコレクションに追加されます。

例外

ArgumentOutOfRangeException

index パラメーターが 0 未満であるか、ListView.ListViewItemCollectionの Count プロパティの値より大きい値です。

注釈

Insert メソッドは、アイテムのName プロパティを指定したキーに設定し、インデックスまたはキーでアイテムを取得できるようにします。

Insert(Int32, String, String)

ソース:

ListView.ListViewItemCollection.cs

指定したテキストと画像を含む新しい項目を作成し、コレクション内の指定したインデックス位置に挿入します。

public:
 System::Windows::Forms::ListViewItem ^ Insert(int index, System::String ^ text, System::String ^ imageKey);

public System.Windows.Forms.ListViewItem Insert(int index, string? text, string? imageKey);

member this.Insert : int * string * string -> System.Windows.Forms.ListViewItem

Public Function Insert (index As Integer, text As String, imageKey As String) As ListViewItem

パラメーター

index

Int32

項目が挿入される 0 から始まるインデックス位置。

text

String

ListViewItemのテキスト。

imageKey

String

アイテムに表示するイメージのキー。

戻り値

ListViewItem

ListViewItemコレクションに追加されます。

例外

ArgumentOutOfRangeException

index パラメーターが 0 未満であるか、ListView.ListViewItemCollectionの Count プロパティの値より大きい値です。

Insert(Int32, ListViewItem)

ソース:

ListView.ListViewItemCollection.cs

指定したインデックス位置にあるコレクションに既存の ListViewItem を挿入します。

public:
 System::Windows::Forms::ListViewItem ^ Insert(int index, System::Windows::Forms::ListViewItem ^ item);

public System.Windows.Forms.ListViewItem Insert(int index, System.Windows.Forms.ListViewItem item);

member this.Insert : int * System.Windows.Forms.ListViewItem -> System.Windows.Forms.ListViewItem

Public Function Insert (index As Integer, item As ListViewItem) As ListViewItem

パラメーター

index

Int32

項目が挿入される 0 から始まるインデックス位置。

item

ListViewItem

挿入する項目を表す ListViewItem 。

戻り値

ListViewItem

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

例外

ArgumentOutOfRangeException

index パラメーターが 0 未満であるか、ListView.ListViewItemCollectionの Count プロパティの値より大きい値です。

注釈

このバージョンの Insert メソッドを使用すると、ListView.ListViewItemCollection内の特定の位置に既存のListViewItemを挿入できます。

注

ListView.Sorting プロパティが SortOrder.None 以外の値に設定されている場合、または ListViewItemSorter プロパティが設定されている場合は、項目が挿入された後にリストが並べ替えられます。

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

こちらもご覧ください

• Add(String)
• AddRange(ListViewItem[])

Insert(Int32, String)

ソース:

ListView.ListViewItemCollection.cs

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

public:
 System::Windows::Forms::ListViewItem ^ Insert(int index, System::String ^ text);

public System.Windows.Forms.ListViewItem Insert(int index, string? text);

member this.Insert : int * string -> System.Windows.Forms.ListViewItem

Public Function Insert (index As Integer, text As String) As ListViewItem

パラメーター

index

Int32

項目が挿入される 0 から始まるインデックス位置。

text

String

アイテムに表示するテキスト。

戻り値

ListViewItem

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

例外

ArgumentOutOfRangeException

index パラメーターが 0 未満であるか、ListView.ListViewItemCollectionの Count プロパティの値より大きい値です。

注釈

このバージョンの Insert メソッドを使用すると、 ListView.ListViewItemCollection内の特定の位置に新しい項目を挿入できます。 text パラメーターで指定されたテキストを使用して、新しいListViewItemを作成し、指定した場所のListView.ListViewItemCollectionに挿入します。

注

ListView.Sorting プロパティが SortOrder.None 以外の値に設定されている場合、または ListViewItemSorter プロパティが設定されている場合は、項目が挿入された後にリストが並べ替えられます。

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

こちらもご覧ください

• Add(String)
• AddRange(ListViewItem[])

Insert(Int32, String, Int32)

ソース:

ListView.ListViewItemCollection.cs

指定したイメージ インデックスを持つ新しい項目を作成し、指定したインデックス位置にあるコレクションに挿入します。

public:
 System::Windows::Forms::ListViewItem ^ Insert(int index, System::String ^ text, int imageIndex);

public System.Windows.Forms.ListViewItem Insert(int index, string? text, int imageIndex);

member this.Insert : int * string * int -> System.Windows.Forms.ListViewItem

Public Function Insert (index As Integer, text As String, imageIndex As Integer) As ListViewItem

パラメーター

index

Int32

項目が挿入される 0 から始まるインデックス位置。

text

String

アイテムに表示するテキスト。

imageIndex

Int32

アイテムに表示するイメージのインデックス。

戻り値

ListViewItem

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

例外

ArgumentOutOfRangeException

index パラメーターが 0 未満であるか、ListView.ListViewItemCollectionの Count プロパティの値より大きい値です。

注釈

このバージョンの Insert メソッドを使用すると、 ListView.ListViewItemCollection内の特定の位置に新しい項目を挿入できます。 text パラメーターで指定されたテキストを使用して、新しいListViewItemを作成し、指定した場所のListView.ListViewItemCollectionに挿入します。

注

ListView.Sorting プロパティが SortOrder.None 以外の値に設定されている場合、または ListViewItemSorter プロパティが設定されている場合は、項目が挿入された後にリストが並べ替えられます。

このバージョンの Insert メソッドを使用して、ListView.LargeImageListに割り当てられたImageListのインデックスを渡し、プロパティをimageIndex パラメーターにListView.SmallImageListすることで、アイテムのイメージを指定することもできます。 (通常、 ListView.LargeImageList プロパティと ListView.SmallImageList プロパティは、同じインデックス位置を使用して関連する画像を表示します)。アイテムのイメージ インデックスを指定しない場合は、文字列をパラメーターとして受け取る他のバージョンの Insert メソッドを使用します。

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

こちらもご覧ください

• Add(String)
• AddRange(ListViewItem[])