ListView.ListViewItemCollection.Add メソッド
定義
重要
一部の情報は、リリース前に大きく変更される可能性があるプレリリースされた製品に関するものです。 Microsoft は、ここに記載されている情報について、明示または黙示を問わず、一切保証しません。
項目のコレクションに項目を追加します。
オーバーロード
| 名前 | 説明 |
|---|---|
| Add(String) |
指定したテキストを持つ項目を作成し、コレクションに追加します。 |
| Add(ListViewItem) |
コレクションに既存の ListViewItem を追加します。 |
| Add(String, Int32) |
指定したテキストとイメージを持つ項目を作成し、コレクションに追加します。 |
| Add(String, String) |
指定したテキストとイメージを持つ項目を作成し、コレクションに追加します。 |
| Add(String, String, Int32) |
指定したキー、テキスト、およびイメージを持つ項目を作成し、コレクションに項目を追加します。 |
| Add(String, String, String) |
指定したキー、テキスト、およびイメージを持つ項目を作成し、コレクションに追加します。 |
Add(String)
指定したテキストを持つ項目を作成し、コレクションに追加します。
public:
virtual System::Windows::Forms::ListViewItem ^ Add(System::String ^ text);public virtual System.Windows.Forms.ListViewItem Add(string text);public virtual System.Windows.Forms.ListViewItem Add(string? text);abstract member Add : string -> System.Windows.Forms.ListViewItem
override this.Add : string -> System.Windows.Forms.ListViewItemPublic Overridable Function Add (text As String) As ListViewItemパラメーター
- text
- String
アイテムに表示するテキスト。
戻り値
コレクションに追加された ListViewItem 。
注釈
このバージョンの Add メソッドを使用して、ListView コントロールに追加する新しいListViewItemを作成できます。 コントロールに追加された新しい ListViewItem のテキストは、 text パラメーターに基づいています。 アイテムのイメージを指定する場合は、イメージ インデックスをパラメーターとして受け入れる Add メソッドのバージョンを使用します。 コレクションに追加する既存のListViewItemがある場合は、パラメーターとしてListViewItemを受け入れる Add メソッドのバージョンを使用します。
ListView.Sorting プロパティが SortOrder.None 以外の値に設定されている場合、または ListViewItemSorter プロパティが設定されている場合、リストは項目の追加後に並べ替えられます。 それ以外の場合、項目はリストの末尾に挿入されます。 リストが並べ替えられない場合は、 Insert メソッドを使用して、特定の位置にある ListView に項目を挿入できます。 1 回の操作でコントロールに項目のセットを追加するには、 AddRange メソッドを使用します。 Add メソッドを使用して多数の項目をコントロールに追加する場合は、BeginUpdateメソッドと EndUpdate メソッドを使用して、すべての項目が追加されるまでListViewが再描画されないようにします。 ListViewに項目を追加する場合は、最初に項目を並べ替えてから新しい項目を追加する方が効率的です。
こちらもご覧ください
適用対象
Add(ListViewItem)
コレクションに既存の ListViewItem を追加します。
public:
virtual System::Windows::Forms::ListViewItem ^ Add(System::Windows::Forms::ListViewItem ^ value);public virtual System.Windows.Forms.ListViewItem Add(System.Windows.Forms.ListViewItem value);abstract member Add : System.Windows.Forms.ListViewItem -> System.Windows.Forms.ListViewItem
override this.Add : System.Windows.Forms.ListViewItem -> System.Windows.Forms.ListViewItemPublic Overridable Function Add (value As ListViewItem) As ListViewItemパラメーター
- value
- ListViewItem
コレクションに追加する ListViewItem 。
戻り値
コレクションに追加された ListViewItem 。
注釈
このバージョンの Add メソッドを使用して、コレクションに既存の ListViewItem を追加できます。 このバージョンの Add メソッドは、通常、他の ListView コントロールの項目を再利用したり、コレクションに追加する前に ListViewItem が手動で作成された場合に使用されます。 既存の項目を使用する代わりに新しい ListViewItem を作成する場合は、他のバージョンの Add メソッドを使用します。
ListView.Sorting プロパティが SortOrder.None 以外の値に設定されている場合、または ListViewItemSorter プロパティが設定されている場合、リストは項目の追加後に並べ替えられます。 それ以外の場合、項目はリストの末尾に挿入されます。 リストが並べ替えられない場合は、 Insert メソッドを使用して、特定の位置にある ListView に項目を挿入できます。 1 回の操作でコントロールに項目のセットを追加するには、 AddRange メソッドを使用します。 Add メソッドを使用して多数の項目をコントロールに追加する場合は、BeginUpdateメソッドと EndUpdate メソッドを使用して、すべての項目が追加されるまでListViewが再描画されないようにします。 ListViewに項目を追加する場合は、最初に項目を並べ替えてから新しい項目を追加する方が効率的です。
このバージョンの Add メソッドは、 ListViewItem を ListViewGroupに割り当てるためにも使用されます。
こちらもご覧ください
適用対象
Add(String, Int32)
指定したテキストとイメージを持つ項目を作成し、コレクションに追加します。
public:
virtual System::Windows::Forms::ListViewItem ^ Add(System::String ^ text, int imageIndex);public virtual System.Windows.Forms.ListViewItem Add(string text, int imageIndex);public virtual System.Windows.Forms.ListViewItem Add(string? text, int imageIndex);abstract member Add : string * int -> System.Windows.Forms.ListViewItem
override this.Add : string * int -> System.Windows.Forms.ListViewItemPublic Overridable Function Add (text As String, imageIndex As Integer) As ListViewItemパラメーター
- text
- String
アイテムのテキスト。
- imageIndex
- Int32
アイテムに表示するイメージのインデックス。
戻り値
コレクションに追加された ListViewItem 。
注釈
このバージョンの Add メソッドを使用して、ListView コントロールに追加する新しいListViewItemを作成できます。 コントロールに追加された新しい ListViewItem のテキストは、 text パラメーターに基づいています。
ListView.LargeImageListに割り当てられたImageListのインデックスを渡し、プロパティをimageIndex パラメーターにListView.SmallImageListすることで、アイテムのイメージを指定することもできます。 (通常、 ListView.LargeImageList プロパティと ListView.SmallImageList プロパティは、同じインデックス位置を使用して関連する画像を表示します)。アイテムのイメージ インデックスを指定しない場合は、パラメーターとして文字列のみを受け取る Add メソッドのバージョンを使用します。 コレクションに追加する既存のListViewItemがある場合は、パラメーターとしてListViewItemを受け入れる Add メソッドのバージョンを使用します。
ListView.Sorting プロパティが SortOrder.None 以外の値に設定されている場合、または ListViewItemSorter プロパティが設定されている場合、リストは項目の追加後に並べ替えられます。 それ以外の場合、項目はリストの末尾に挿入されます。 リストが並べ替えられない場合は、 Insert メソッドを使用して、特定の位置にある ListView に項目を挿入できます。 1 回の操作でコントロールに項目のセットを追加するには、 AddRange メソッドを使用します。 Add メソッドを使用して多数の項目をコントロールに追加する場合は、BeginUpdateメソッドと EndUpdate メソッドを使用して、すべての項目が追加されるまでListViewが再描画されないようにします。 ListViewに項目を追加する場合は、最初に項目を並べ替えてから新しい項目を追加する方が効率的です。
こちらもご覧ください
適用対象
Add(String, String)
指定したテキストとイメージを持つ項目を作成し、コレクションに追加します。
public:
virtual System::Windows::Forms::ListViewItem ^ Add(System::String ^ text, System::String ^ imageKey);public virtual System.Windows.Forms.ListViewItem Add(string text, string imageKey);public virtual System.Windows.Forms.ListViewItem Add(string? text, string? imageKey);abstract member Add : string * string -> System.Windows.Forms.ListViewItem
override this.Add : string * string -> System.Windows.Forms.ListViewItemPublic Overridable Function Add (text As String, imageKey As String) As ListViewItemパラメーター
- text
- String
アイテムのテキスト。
- imageKey
- String
アイテムに表示するイメージのキー。
戻り値
ListViewItemコレクションに追加されます。
注釈
ListViewが並べ替えられた場合、項目は正しく並べ替えられた順序で追加されます。それ以外の場合は、コレクションの末尾に追加されます。
適用対象
Add(String, String, Int32)
指定したキー、テキスト、およびイメージを持つ項目を作成し、コレクションに項目を追加します。
public:
virtual System::Windows::Forms::ListViewItem ^ Add(System::String ^ key, System::String ^ text, int imageIndex);public virtual System.Windows.Forms.ListViewItem Add(string key, string text, int imageIndex);public virtual System.Windows.Forms.ListViewItem Add(string? key, string? text, int imageIndex);abstract member Add : string * string * int -> System.Windows.Forms.ListViewItem
override this.Add : string * string * int -> System.Windows.Forms.ListViewItemPublic Overridable Function Add (key As String, text As String, imageIndex As Integer) As ListViewItemパラメーター
- key
- String
品目の名前。
- text
- String
アイテムのテキスト。
- imageIndex
- Int32
アイテムに表示するイメージのインデックス。
戻り値
ListViewItemコレクションに追加されます。
例外
含まれる ListView は仮想モードです。
注釈
ListViewが並べ替えられた場合、項目は正しく並べ替えられた順序で追加されます。それ以外の場合は、コレクションの末尾に追加されます。 Name プロパティは、ListView.ListViewItemCollection内のListViewItemのキーに対応します。
Add メソッドは、Name プロパティを指定したキーに設定し、インデックスまたはキーで項目を取得できるようにします。
適用対象
Add(String, String, String)
指定したキー、テキスト、およびイメージを持つ項目を作成し、コレクションに追加します。
public:
virtual System::Windows::Forms::ListViewItem ^ Add(System::String ^ key, System::String ^ text, System::String ^ imageKey);public virtual System.Windows.Forms.ListViewItem Add(string key, string text, string imageKey);public virtual System.Windows.Forms.ListViewItem Add(string? key, string? text, string? imageKey);abstract member Add : string * string * string -> System.Windows.Forms.ListViewItem
override this.Add : string * string * string -> System.Windows.Forms.ListViewItemPublic Overridable Function Add (key As String, text As String, imageKey As String) As ListViewItemパラメーター
- key
- String
品目の名前。
- text
- String
アイテムのテキスト。
- imageKey
- String
アイテムに表示するイメージのキー。
戻り値
ListViewItemコレクションに追加されます。
注釈
Name プロパティは、ListView.ListViewItemCollection内のListViewItemのキーに対応します。
ListViewが並べ替えられた場合、項目は正しく並べ替えられた順序で追加されます。それ以外の場合は、コレクションの末尾に追加されます。 Add メソッドは、アイテムのName プロパティを指定したキーに設定し、インデックスまたはキーでアイテムを取得できるようにします。
