ListView.ListViewItemCollection.Insert メソッド

定義

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

オーバーロード

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)

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

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);
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

例外

index パラメーターが 0 未満か、CountListView.ListViewItemCollection プロパティの値を超える値です。

注釈

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

適用対象

Insert(Int32, String, String, Int32)

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

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);
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

例外

index パラメーターが 0 未満か、CountListView.ListViewItemCollection プロパティの値を超える値です。

注釈

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

適用対象

Insert(Int32, String, String)

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

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);
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

例外

index パラメーターが 0 未満か、CountListView.ListViewItemCollection プロパティの値を超える値です。

適用対象

Insert(Int32, ListViewItem)

既存の 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

例外

index パラメーターが 0 未満か、CountListView.ListViewItemCollection プロパティの値を超える値です。

注釈

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

注意

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

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

こちらもご覧ください

適用対象

Insert(Int32, String)

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

public:
 System::Windows::Forms::ListViewItem ^ Insert(int index, System::String ^ text);
public System.Windows.Forms.ListViewItem Insert (int index, 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

例外

index パラメーターが 0 未満か、CountListView.ListViewItemCollection プロパティの値を超える値です。

注釈

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

注意

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

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

こちらもご覧ください

適用対象

Insert(Int32, String, Int32)

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

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);
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

例外

index パラメーターが 0 未満か、CountListView.ListViewItemCollection プロパティの値を超える値です。

注釈

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

注意

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

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

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

こちらもご覧ください

適用対象