ListView.ListViewItemCollection.Add 메서드

정의

항목을 항목의 컬렉션에 추가합니다.Adds an item to the collection of items.

오버로드

Add(String)

지정된 텍스트를 사용하여 항목을 만든 다음 컬렉션에 추가합니다.Creates an item with the specified text and adds it to the collection.

Add(ListViewItem)

기존 ListViewItem을 컬렉션에 추가합니다.Adds an existing ListViewItem to the collection.

Add(String, Int32)

지정된 텍스트와 이미지를 사용하여 항목을 만든 다음 컬렉션에 추가합니다.Creates an item with the specified text and image and adds it to the collection.

Add(String, String)

지정된 텍스트와 이미지를 사용하여 항목을 만든 다음 컬렉션에 추가합니다.Creates an item with the specified text and image and adds it to the collection.

Add(String, String, Int32)

지정된 키, 텍스트 및 이미지를 사용하여 항목을 만든 다음 컬렉션에 추가합니다.Creates an item with the specified key, text, and image and adds an item to the collection.

Add(String, String, String)

지정된 키, 텍스트 및 이미지를 사용하여 항목을 만든 다음 컬렉션에 추가합니다.Creates an item with the specified key, text, and image, and adds it to the collection.

Add(String)

지정된 텍스트를 사용하여 항목을 만든 다음 컬렉션에 추가합니다.Creates an item with the specified text and adds it to the collection.

public:
 virtual System::Windows::Forms::ListViewItem ^ Add(System::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.ListViewItem
Public Overridable Function Add (text As String) As ListViewItem

매개 변수

text
String

항목에 대해 표시할 텍스트입니다.The text to display for the item.

반환

ListViewItem

컬렉션에 추가된 ListViewItem입니다.The ListViewItem that was added to the collection.

설명

이 버전의 메서드를 사용 하 여 Add ListViewItem 컨트롤에 추가할 새을 만들 수 있습니다 ListView .You can use this version of the Add method to create a new ListViewItem to add to a ListView control. 컨트롤에 추가 된 새의 텍스트는 ListViewItem 매개 변수를 기반으로 text 합니다.The text of the new ListViewItem added to the control is based on the text parameter. 항목에 대 한 이미지를 지정 하려면 Add 이미지 인덱스를 매개 변수로 허용 하는 메서드 버전을 사용 합니다.If you want to specify an image for the item, use the version of the Add method that accepts an image index as a parameter. 컬렉션에 추가할 기존가 있는 경우 ListViewItem Add 를 매개 변수로 사용 하는 메서드 버전을 사용 ListViewItem 합니다.If you have an existing ListViewItem that you want to add to the collection, use the version of the Add method that accepts a ListViewItem as its parameter.

ListView.Sorting속성이가 아닌 값으로 설정 된 경우 SortOrder.None 또는 ListViewItemSorter 속성이 설정 되어 있으면 항목이 추가 된 후 목록이 정렬 됩니다.If the ListView.Sorting property is set to a value other than SortOrder.None or if the ListViewItemSorter property is set, the list is sorted after the item is added. 그렇지 않으면 항목이 목록의 끝에 삽입 됩니다.Otherwise, the item is inserted at the end of the list. 목록이 정렬 되어 있지 않으면 메서드를 사용 Insert 하 여 특정 위치에 항목을에 삽입할 수 있습니다 ListView .If the list is not sorted, you can use the Insert method to insert an item into the ListView at a specific position. 단일 작업에서 컨트롤에 항목 집합을 추가 하려면 메서드를 사용 AddRange 합니다.To add a set of items to the control in a single operation, use the AddRange method. 메서드를 사용 하 여 Add 많은 수의 항목을 컨트롤에 추가 하려면 및 메서드를 사용 하 여 BeginUpdate EndUpdate ListView 모든 항목이 추가 될 때까지가 다시 그려지지 않도록 합니다.If you want to use the Add method to add a large number of items to the control, use the BeginUpdate and EndUpdate methods to prevent the ListView from repainting until all items are added. 항목을에 추가할 때 ListView 먼저 항목을 정렬 한 다음 새 항목을 추가 하는 것이 더 효율적입니다.When adding items to a ListView, it is more efficient to sort the items first and then add new items.

추가 정보

적용 대상

Add(ListViewItem)

기존 ListViewItem을 컬렉션에 추가합니다.Adds an existing ListViewItem to the collection.

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.ListViewItem
Public Overridable Function Add (value As ListViewItem) As ListViewItem

매개 변수

value
ListViewItem

컬렉션에 추가할 ListViewItem입니다.The ListViewItem to add to the collection.

반환

ListViewItem

컬렉션에 추가된 ListViewItem입니다.The ListViewItem that was added to the collection.

설명

이 버전을 사용할 수는 Add 메서드는 기존 항목 추가를 ListViewItem 컬렉션에 있습니다.You can use this version of the Add method to add an existing ListViewItem to the collection. 이 버전의 Add 메서드는 일반적으로 다른 컨트롤의 항목을 다시 사용 ListView 하거나를 ListViewItem 컬렉션에 추가 하기 전에 수동으로 만든 경우에 사용 됩니다.This version of the Add method is typically used to reuse items from other ListView controls or if the ListViewItem was created manually before adding it to the collection. ListViewItem기존 항목을 사용 하는 대신 새을 만들려면 다른 버전의 메서드를 사용 Add 합니다.If you want to create a new ListViewItem instead of using an existing item, use the other versions of the Add method.

ListView.Sorting속성이가 아닌 값으로 설정 된 경우 SortOrder.None 또는 ListViewItemSorter 속성이 설정 되어 있으면 항목이 추가 된 후 목록이 정렬 됩니다.If the ListView.Sorting property is set to a value other than SortOrder.None or if the ListViewItemSorter property is set, the list is sorted after the item is added. 그렇지 않으면 항목이 목록의 끝에 삽입 됩니다.Otherwise, the item is inserted at the end of the list. 목록이 정렬 되어 있지 않으면 메서드를 사용 Insert 하 여 특정 위치에 항목을에 삽입할 수 있습니다 ListView .If the list is not sorted, you can use the Insert method to insert an item into the ListView at a specific position. 단일 작업에서 컨트롤에 항목 집합을 추가 하려면 메서드를 사용 AddRange 합니다.To add a set of items to the control in a single operation, use the AddRange method. 메서드를 사용 하 여 Add 많은 수의 항목을 컨트롤에 추가 하려면 및 메서드를 사용 하 여 BeginUpdate EndUpdate ListView 모든 항목이 추가 될 때까지가 다시 그려지지 않도록 합니다.If you want to use the Add method to add a large number of items to the control, use the BeginUpdate and EndUpdate methods to prevent the ListView from repainting until all items are added. 항목을에 추가할 때 ListView 먼저 항목을 정렬 한 다음 새 항목을 추가 하는 것이 더 효율적입니다.When adding items to a ListView, it is more efficient to sort the items first and then add new items.

이 버전의 메서드는를에 Add 할당 하는 데도 사용 됩니다 ListViewItem ListViewGroup .This version of the Add method is also used to assign a ListViewItem to a ListViewGroup.

추가 정보

적용 대상

Add(String, Int32)

지정된 텍스트와 이미지를 사용하여 항목을 만든 다음 컬렉션에 추가합니다.Creates an item with the specified text and image and adds it to the collection.

public:
 virtual System::Windows::Forms::ListViewItem ^ Add(System::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.ListViewItem
Public Overridable Function Add (text As String, imageIndex As Integer) As ListViewItem

매개 변수

text
String

항목의 텍스트입니다.The text of the item.

imageIndex
Int32

항목에 대해 표시할 이미지의 인덱스입니다.The index of the image to display for the item.

반환

ListViewItem

컬렉션에 추가된 ListViewItem입니다.The ListViewItem that was added to the collection.

설명

이 버전의 메서드를 사용 하 여 Add ListViewItem 컨트롤에 추가할 새을 만들 수 있습니다 ListView .You can use this version of the Add method to create a new ListViewItem to add to the ListView control. 컨트롤에 추가 된 새의 텍스트는 ListViewItem 매개 변수를 기반으로 text 합니다.The text of the new ListViewItem added to the control is based on the text parameter. ImageList및 속성에 할당 된의 인덱스를 ListView.LargeImageList ListView.SmallImageList imageIndex 매개 변수에 전달 하 여 항목의 이미지를 지정할 수도 있습니다.You can also specify an image for the item by passing the index of the ImageList assigned to the ListView.LargeImageList and ListView.SmallImageList properties to the imageIndex parameter. 일반적으로 ListView.LargeImageList 및 속성은 ListView.SmallImageList 동일한 인덱스 위치를 사용 하 여 관련 이미지를 표시 합니다. 항목에 대 한 이미지 인덱스를 지정 하지 않으려면 Add 문자열만 매개 변수로 허용 하는 메서드 버전을 사용 합니다.(Typically, the ListView.LargeImageList and ListView.SmallImageList properties use the same index positions to display related images.) If you do not want to specify an image index for the item, use the version of the Add method that accepts only a string as a parameter. 컬렉션에 추가할 기존가 있는 경우 ListViewItem Add 를 매개 변수로 사용 하는 메서드 버전을 사용 ListViewItem 합니다.If you have an existing ListViewItem that you want to add to the collection, use the version of the Add method that accepts a ListViewItem as its parameter.

ListView.Sorting속성이가 아닌 값으로 설정 된 경우 SortOrder.None 또는 ListViewItemSorter 속성이 설정 되어 있으면 항목이 추가 된 후 목록이 정렬 됩니다.If the ListView.Sorting property is set to a value other than SortOrder.None or if the ListViewItemSorter property is set, the list is sorted after the item is added. 그렇지 않으면 항목이 목록의 끝에 삽입 됩니다.Otherwise, the item is inserted at the end of the list. 목록이 정렬 되어 있지 않으면 메서드를 사용 Insert 하 여 특정 위치에 항목을에 삽입할 수 있습니다 ListView .If the list is not sorted, you can use the Insert method to insert an item into the ListView at a specific position. 단일 작업에서 컨트롤에 항목 집합을 추가 하려면 메서드를 사용 AddRange 합니다.To add a set of items to the control in a single operation, use the AddRange method. 메서드를 사용 하 여 Add 많은 수의 항목을 컨트롤에 추가 하려면 및 메서드를 사용 하 여 BeginUpdate EndUpdate ListView 모든 항목이 추가 될 때까지가 다시 그려지지 않도록 합니다.If you want to use the Add method to add a large number of items to the control, use the BeginUpdate and EndUpdate methods to prevent the ListView from repainting until all items are added. 항목을에 추가할 때 ListView 먼저 항목을 정렬 한 다음 새 항목을 추가 하는 것이 더 효율적입니다.When adding items to a ListView, it is more efficient to sort the items first and then add new items.

추가 정보

적용 대상

Add(String, String)

지정된 텍스트와 이미지를 사용하여 항목을 만든 다음 컬렉션에 추가합니다.Creates an item with the specified text and image and adds it to the collection.

public:
 virtual System::Windows::Forms::ListViewItem ^ Add(System::String ^ text, System::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.ListViewItem
Public Overridable Function Add (text As String, imageKey As String) As ListViewItem

매개 변수

text
String

항목의 텍스트입니다.The text of the item.

imageKey
String

항목에 대해 표시할 이미지의 키입니다.The key of the image to display for the item.

반환

ListViewItem

컬렉션에 추가된 ListViewItem입니다.The ListViewItem added to the collection.

설명

ListView이 정렬 되어 있으면 항목이 올바르게 정렬 된 순서로 추가 되 고, 그렇지 않으면 컬렉션의 끝에 추가 됩니다.If the ListView is sorted, the item is added in the correctly sorted order; otherwise, it is added to the end of the collection.

적용 대상

Add(String, String, Int32)

지정된 키, 텍스트 및 이미지를 사용하여 항목을 만든 다음 컬렉션에 추가합니다.Creates an item with the specified key, text, and image and adds an item to the collection.

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);
abstract member Add : string * string * int -> System.Windows.Forms.ListViewItem
override this.Add : string * string * int -> System.Windows.Forms.ListViewItem
Public Overridable Function Add (key As String, text As String, imageIndex As Integer) As ListViewItem

매개 변수

key
String

항목의 이름입니다.The name of the item.

text
String

항목의 텍스트입니다.The text of the item.

imageIndex
Int32

항목에 대해 표시할 이미지의 인덱스입니다.The index of the image to display for the item.

반환

ListViewItem

컬렉션에 추가된 ListViewItem입니다.The ListViewItem added to the collection.

예외

포함하는 ListView가 가상 모드에 있는 경우The containing ListView is in virtual mode.

설명

ListView이 정렬 되어 있으면 항목이 올바르게 정렬 된 순서로 추가 되 고, 그렇지 않으면 컬렉션의 끝에 추가 됩니다.If the ListView is sorted, the item is added in the correctly sorted order; otherwise, it is added to the end of the collection. Name 키에 해당 하는 속성을 ListViewItemListView.ListViewItemCollection합니다.The Name property corresponds to the key for a ListViewItem in the ListView.ListViewItemCollection.

Add메서드는 속성을 Name 지정 된 키로 설정 하므로 인덱스 또는 키를 기준으로 항목을 검색할 수 있습니다.The Add method sets the Name property to the specified key, so the item can be retrieved by its index or by key.

적용 대상

Add(String, String, String)

지정된 키, 텍스트 및 이미지를 사용하여 항목을 만든 다음 컬렉션에 추가합니다.Creates an item with the specified key, text, and image, and adds it to the collection.

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);
abstract member Add : string * string * string -> System.Windows.Forms.ListViewItem
override this.Add : string * string * string -> System.Windows.Forms.ListViewItem
Public Overridable Function Add (key As String, text As String, imageKey As String) As ListViewItem

매개 변수

key
String

항목의 이름입니다.The name of the item.

text
String

항목의 텍스트입니다.The text of the item.

imageKey
String

항목에 대해 표시할 이미지의 키입니다.The key of the image to display for the item.

반환

ListViewItem

컬렉션에 추가된 ListViewItem입니다.The ListViewItem added to the collection.

설명

Name 키에 해당 하는 속성을 ListViewItemListView.ListViewItemCollection합니다.The Name property corresponds to the key for a ListViewItem in the ListView.ListViewItemCollection.

ListView이 정렬 되어 있으면 항목이 올바르게 정렬 된 순서로 추가 되 고, 그렇지 않으면 컬렉션의 끝에 추가 됩니다.If the ListView is sorted, the item is added in the correctly sorted order; otherwise, it is added to the end of the collection. Add메서드는 Name 항목의 속성을 지정 된 키로 설정 하므로 인덱스 또는 키를 기준으로 항목을 검색할 수 있습니다.The Add method sets the Name property of the item to the specified key, so the item can be retrieved by its index or by key.

적용 대상