ListView.ListViewItemCollection.Insert メソッド

リファレンス

定義

名前空間:: System.Windows.Forms

アセンブリ:: System.Windows.Forms.dll

重要

一部の情報は、リリース前に大きく変更される可能性があるプレリリースされた製品に関するものです。 Microsoft は、ここに記載されている情報について、明示または黙示を問わず、一切保証しません。

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

オーバーロード

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

コレクションに追加する ListViewItem。

例外

ArgumentOutOfRangeException

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

注釈

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

適用対象

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

コレクションに追加する ListViewItem。

例外

ArgumentOutOfRangeException

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

注釈

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

適用対象

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

コレクションに追加する ListViewItem。

例外

ArgumentOutOfRangeException

index パラメーターが 0 未満か、Count の ListView.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

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

例外

ArgumentOutOfRangeException

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

注釈

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

注意

プロパティが以外SortOrder.NoneのListView.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

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

例外

ArgumentOutOfRangeException

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

注釈

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

注意

コレクション内の特定の位置を指定せずに項目を追加するには、メソッドを使用します 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

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

例外

ArgumentOutOfRangeException

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

注釈

注意

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

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

こちらもご覧ください

適用対象

次の方法で共有

ListView.ListViewItemCollection.Insert メソッド

定義

オーバーロード

Insert(Int32, String, String, String)

パラメーター

戻り値

例外

注釈

適用対象

Insert(Int32, String, String, Int32)

パラメーター

戻り値

例外

注釈

適用対象

Insert(Int32, String, String)

パラメーター

戻り値

例外

適用対象

Insert(Int32, ListViewItem)

パラメーター

戻り値

例外

注釈

こちらもご覧ください

適用対象

Insert(Int32, String)

パラメーター

戻り値

例外

注釈

こちらもご覧ください

適用対象

Insert(Int32, String, Int32)

パラメーター

戻り値

例外

注釈

こちらもご覧ください

適用対象

その他のリソース