ListView.ListViewItemCollection.Insert 메서드

정의

네임스페이스:

System.Windows.Forms

어셈블리:

System.Windows.Forms.dll

항목을 컬렉션 내의 지정된 인덱스에 삽입합니다.

오버로드

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

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

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

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.

참고

속성이 ListView.Sorting 다른 SortOrder.None 값으로 설정되거나 속성이 ListViewItemSorter 설정된 경우 항목이 삽입된 후 목록이 정렬됩니다.

항목을 추가할 컬렉션의 특정 위치를 지정하지 않고 항목을 추가하려면 메서드를 Add 사용합니다. 컬렉션에 항목 배열을 추가하려면 메서드를 AddRange 사용합니다. 기존 항목 컬렉션에 새 항목을 삽입하려는 경우 이 메서드를 사용할 수 있습니다.

추가 정보

• Add(String)
• AddRange(ListViewItem[])

Insert(Int32, String)

새 항목을 만들어 컬렉션의 지정한 인덱스에 삽입합니다.

public:
 System::Windows::Forms::ListViewItem ^ Insert(int index, System::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 지정된 텍스트는 지정된 위치에 삽입되는 ListView.ListViewItemCollection 새 ListViewItem 텍스트를 만드는 데 사용됩니다.

참고

속성이 ListView.Sorting 다른 SortOrder.None 값으로 설정되거나 속성이 ListViewItemSorter 설정된 경우 항목이 삽입된 후 목록이 정렬됩니다.

컬렉션에서 특정 위치를 지정하지 않고 항목을 추가하려면 메서드를 Add 사용합니다. 컬렉션에 항목 배열을 추가하려면 메서드를 AddRange 사용합니다. 기존 항목 컬렉션에 새 항목을 삽입하려는 경우 이 메서드를 사용할 수 있습니다.

추가 정보

• Add(String)
• AddRange(ListViewItem[])

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

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.ListViewItemCollection. 매개 변수에 text 지정된 텍스트는 지정된 위치에 삽입되는 ListView.ListViewItemCollection 새 ListViewItem 텍스트를 만드는 데 사용됩니다.

참고

속성이 ListView.Sorting 다른 SortOrder.None 값으로 설정되거나 속성이 ListViewItemSorter 설정된 경우 항목이 삽입된 후 목록이 정렬됩니다.

이 버전의 메서드를 Insert 사용하여 할당된 ListView.LargeImageList 인덱 ImageList 스와 ListView.SmallImageList 속성을 imageIndex 매개 변수에 전달하여 항목에 대한 이미지를 지정할 수도 있습니다. (일반적으로 및 ListView.SmallImageList 속성은 ListView.LargeImageList 동일한 인덱스 위치를 사용하여 관련 이미지를 표시합니다.) 항목에 대한 이미지 인덱스를 지정하지 않으려면 문자열을 매개 변수로 허용하는 메서드의 Insert 다른 버전을 사용합니다.

컬렉션에서 특정 위치를 지정하지 않고 항목을 추가하려면 메서드를 Add 사용합니다. 컬렉션에 항목 배열을 추가하려면 메서드를 AddRange 사용합니다.

추가 정보

• Add(String)
• AddRange(ListViewItem[])