ListView.ListViewItemCollection.Add 메서드

정의

네임스페이스:

System.Windows.Forms

어셈블리:

System.Windows.Forms.dll

항목을 항목의 컬렉션에 추가합니다.

오버로드

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

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

항목에 대해 표시할 텍스트입니다.

반환

ListViewItem

컬렉션에 추가된 ListViewItem입니다.

설명

이 버전의 메서드를 사용하여 컨트롤에 Add 추가할 새 ListViewItem 메서드를 ListView 만들 수 있습니다. 컨트롤에 추가된 새 ListViewItem 텍스트는 매개 변수를 기반으로 합니다 text . 항목에 대한 이미지를 지정하려면 이미지 인덱스를 매개 변수로 허용하는 메서드의 Add 버전을 사용합니다. 컬렉션에 추가하려는 기존 ListViewItem 항목이 있는 경우 매개 변수로 허용하는 ListViewItem 메서드의 Add 버전을 사용합니다.

속성이 ListView.Sorting 다른 SortOrder.None 값으로 설정되거나 속성이 ListViewItemSorter 설정된 경우 항목이 추가된 후 목록이 정렬됩니다. 그렇지 않으면 항목이 목록의 끝에 삽입됩니다. 목록이 정렬되지 않은 경우 메서드를 Insert 사용하여 특정 위치에 항목을 삽입할 ListView 수 있습니다. 단일 작업에서 컨트롤에 항목 집합을 추가하려면 이 메서드를 AddRange 사용합니다. 메서드를 Add 사용하여 컨트롤에 많은 수의 항목을 추가하려면 메서드와 EndUpdate 메서드를 사용하여 BeginUpdate 모든 항목이 ListView 추가될 때까지 다시 칠하지 않도록 합니다. 항목을 추가할 때 먼저 항목을 ListView정렬한 다음 새 항목을 추가하는 것이 더 효율적입니다.

추가 정보

• AddRange(ListViewItem[])
• Insert(Int32, ListViewItem)
• Sorting

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.ListViewItem

Public Overridable Function Add (value As ListViewItem) As ListViewItem

매개 변수

value

ListViewItem

컬렉션에 추가할 ListViewItem입니다.

반환

ListViewItem

컬렉션에 추가된 ListViewItem입니다.

설명

이 버전을 사용할 수는 Add 메서드는 기존 항목 추가를 ListViewItem 컬렉션에 있습니다. 이 버전의 Add 메서드는 일반적으로 다른 ListView 컨트롤의 항목을 다시 사용하거나 컬렉션에 ListViewItem 추가하기 전에 수동으로 만든 경우에 사용됩니다. 기존 항목을 사용하는 대신 새 ListViewItem 항목을 만들려면 다른 버전의 메서드를 Add 사용합니다.

속성이 ListView.Sorting 다른 SortOrder.None 값으로 설정되거나 속성이 ListViewItemSorter 설정된 경우 항목이 추가된 후 목록이 정렬됩니다. 그렇지 않으면 항목이 목록의 끝에 삽입됩니다. 목록이 정렬되지 않은 경우 메서드를 Insert 사용하여 특정 위치에 항목을 삽입할 ListView 수 있습니다. 단일 작업에서 컨트롤에 항목 집합을 추가하려면 이 메서드를 AddRange 사용합니다. 메서드를 Add 사용하여 컨트롤에 많은 수의 항목을 추가하려면 메서드와 EndUpdate 메서드를 사용하여 BeginUpdate 모든 항목이 ListView 추가될 때까지 다시 칠하지 않도록 합니다. 항목을 추가할 때 먼저 항목을 ListView정렬한 다음 새 항목을 추가하는 것이 더 효율적입니다.

이 버전의 Add 메서드는 .에 할당 ListViewItem 하는 ListViewGroup데도 사용됩니다.

추가 정보

• AddRange(ListViewItem[])
• Insert(Int32, ListViewItem)
• Sorting

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

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

항목의 텍스트입니다.

imageIndex

Int32

항목에 대해 표시할 이미지의 인덱스입니다.

반환

ListViewItem

컬렉션에 추가된 ListViewItem입니다.

설명

이 버전의 메서드를 사용하여 컨트롤에 Add 추가할 새 ListViewItem 메서드를 ListView 만들 수 있습니다. 컨트롤에 추가된 새 ListViewItem 텍스트는 매개 변수를 기반으로 합니다 text . 할당된 인덱 ImageList 스 및 ListView.SmallImageList 속성을 imageIndex 매개 변수에 전달하여 항목에 ListView.LargeImageList 대한 이미지를 지정할 수도 있습니다. (일반적으로 속성과 ListView.SmallImageList 속성은 ListView.LargeImageList 동일한 인덱스 위치를 사용하여 관련 이미지를 표시합니다.) 항목에 대한 이미지 인덱스를 지정하지 않으려면 문자열만 매개 변수로 허용하는 메서드의 Add 버전을 사용합니다. 컬렉션에 추가하려는 기존 ListViewItem 항목이 있는 경우 매개 변수로 허용하는 ListViewItem 메서드의 Add 버전을 사용합니다.

속성이 ListView.Sorting 다른 SortOrder.None 값으로 설정되거나 속성이 ListViewItemSorter 설정된 경우 항목이 추가된 후 목록이 정렬됩니다. 그렇지 않으면 항목이 목록의 끝에 삽입됩니다. 목록이 정렬되지 않은 경우 메서드를 Insert 사용하여 특정 위치에 항목을 삽입할 ListView 수 있습니다. 단일 작업에서 컨트롤에 항목 집합을 추가하려면 이 메서드를 AddRange 사용합니다. 메서드를 Add 사용하여 컨트롤에 많은 수의 항목을 추가하려면 메서드와 EndUpdate 메서드를 사용하여 BeginUpdate 모든 항목이 ListView 추가될 때까지 다시 칠하지 않도록 합니다. 항목을 추가할 때 먼저 항목을 ListView정렬한 다음 새 항목을 추가하는 것이 더 효율적입니다.

추가 정보

• AddRange(ListViewItem[])
• Insert(Int32, ListViewItem)
• Sorting

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

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

항목의 텍스트입니다.

imageKey

String

항목에 대해 표시할 이미지의 키입니다.

반환

ListViewItem

컬렉션에 추가된 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);

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

항목의 이름입니다.

text

String

항목의 텍스트입니다.

imageIndex

Int32

항목에 대해 표시할 이미지의 인덱스입니다.

반환

ListViewItem

컬렉션에 추가된 ListViewItem입니다.

예외

InvalidOperationException

포함하는 ListView가 가상 모드에 있는 경우

설명

ListView 정렬되면 항목이 올바르게 정렬된 순서로 추가되고, 그렇지 않으면 컬렉션의 끝에 추가됩니다. Name 키에 해당 하는 속성을 ListViewItem 에 ListView.ListViewItemCollection합니다.

이 메서드는 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);

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

항목의 이름입니다.

text

String

항목의 텍스트입니다.

imageKey

String

항목에 대해 표시할 이미지의 키입니다.

반환

ListViewItem

컬렉션에 추가된 ListViewItem입니다.

설명

Name 키에 해당 하는 속성을 ListViewItem 에 ListView.ListViewItemCollection합니다.

ListView 정렬되면 항목이 올바르게 정렬된 순서로 추가되고, 그렇지 않으면 컬렉션의 끝에 추가됩니다. 이 메서드는 Add 항목의 속성을 지정된 키로 설정 Name 하므로 인덱스 또는 키로 항목을 검색할 수 있습니다.