ListView.ListViewItemCollection.Insert 메서드
정의
중요
일부 정보는 릴리스되기 전에 상당 부분 수정될 수 있는 시험판 제품과 관련이 있습니다. Microsoft는 여기에 제공된 정보에 대해 어떠한 명시적이거나 묵시적인 보증도 하지 않습니다.
지정된 인덱스의 컬렉션에 항목을 삽입합니다.
오버로드
| Name | Description |
|---|---|
| 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.ListViewItemPublic Overridable Function Insert (index As Integer, key As String, text As String, imageKey As String) As ListViewItem매개 변수
- index
- Int32
항목이 삽입되는 인덱스 위치(0부터 시작하는 위치)입니다.
- text
- String
항목의 텍스트입니다.
- imageKey
- String
항목에 대해 표시할 이미지의 키입니다.
반환
ListViewItem 컬렉션에 추가된 것입니다.
예외
index 매개 변수가 0보다 작거나 CountListView.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.ListViewItemPublic Overridable Function Insert (index As Integer, key As String, text As String, imageIndex As Integer) As ListViewItem매개 변수
- index
- Int32
항목이 삽입되는 인덱스 위치(0부터 시작하는 위치)입니다.
- text
- String
항목의 텍스트입니다.
- imageIndex
- Int32
항목에 대해 표시할 이미지의 인덱스입니다.
반환
ListViewItem 컬렉션에 추가된 것입니다.
예외
index 매개 변수가 0보다 작거나 CountListView.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.ListViewItemPublic Function Insert (index As Integer, text As String, imageKey As String) As ListViewItem매개 변수
- index
- Int32
항목이 삽입되는 인덱스 위치(0부터 시작하는 위치)입니다.
- text
- String
의 텍스트입니다 ListViewItem.
- imageKey
- String
항목에 대해 표시할 이미지의 키입니다.
반환
ListViewItem 컬렉션에 추가된 것입니다.
예외
index 매개 변수가 0보다 작거나 CountListView.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.ListViewItemPublic Function Insert (index As Integer, item As ListViewItem) As ListViewItem매개 변수
- index
- Int32
항목이 삽입되는 인덱스 위치(0부터 시작하는 위치)입니다.
- item
- ListViewItem
ListViewItem 삽입할 항목을 나타내는 값입니다.
반환
ListViewItem 컬렉션에 삽입된 항목입니다.
예외
index 매개 변수가 0보다 작거나 CountListView.ListViewItemCollection.
설명
이 버전의 Insert 메서드를 사용하면 .의 특정 위치에 기존 ListViewItem 항목을 삽입할 수 있습니다 ListView.ListViewItemCollection.
메모
속성이 ListView.Sorting 다른 SortOrder.None 값으로 설정되거나 속성이 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.ListViewItemPublic Function Insert (index As Integer, text As String) As ListViewItem매개 변수
- index
- Int32
항목이 삽입되는 인덱스 위치(0부터 시작하는 위치)입니다.
- text
- String
항목에 대해 표시할 텍스트입니다.
반환
ListViewItem 컬렉션에 삽입된 항목입니다.
예외
index 매개 변수가 0보다 작거나 CountListView.ListViewItemCollection.
설명
이 버전의 Insert 메서드를 사용하면 새 항목을 .의 특정 위치에 삽입할 수 있습니다 ListView.ListViewItemCollection. 매개 변수에 text 지정된 텍스트는 지정된 위치에 삽입되는 ListView.ListViewItemCollection 새 ListViewItem 텍스트를 만드는 데 사용됩니다.
메모
속성이 ListView.Sorting 다른 SortOrder.None 값으로 설정되거나 속성이 ListViewItemSorter 설정된 경우 항목이 삽입된 후 목록이 정렬됩니다.
컬렉션에서 특정 위치를 지정하지 않고 항목을 추가하려면 메서드를 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.ListViewItemPublic Function Insert (index As Integer, text As String, imageIndex As Integer) As ListViewItem매개 변수
- index
- Int32
항목이 삽입되는 인덱스 위치(0부터 시작하는 위치)입니다.
- text
- String
항목에 대해 표시할 텍스트입니다.
- imageIndex
- Int32
항목에 대해 표시할 이미지의 인덱스입니다.
반환
ListViewItem 컬렉션에 삽입된 항목입니다.
예외
index 매개 변수가 0보다 작거나 CountListView.ListViewItemCollection.
설명
이 버전의 Insert 메서드를 사용하면 새 항목을 .의 특정 위치에 삽입할 수 있습니다 ListView.ListViewItemCollection. 매개 변수에 text 지정된 텍스트는 지정된 위치에 삽입되는 ListView.ListViewItemCollection 새 ListViewItem 텍스트를 만드는 데 사용됩니다.
메모
속성이 ListView.Sorting 다른 SortOrder.None 값으로 설정되거나 속성이 ListViewItemSorter 설정된 경우 항목이 삽입된 후 목록이 정렬됩니다.
이 버전의 메서드를 Insert 사용하여 할당된 인덱 ImageList 스와 ListView.SmallImageList 속성을 imageIndex 매개 변수에 전달하여 항목에 ListView.LargeImageList 대한 이미지를 지정할 수도 있습니다. (일반적으로 속성은 ListView.LargeImageListListView.SmallImageList 동일한 인덱스 위치를 사용하여 관련 이미지를 표시합니다.) 항목에 대한 이미지 인덱스를 지정하지 않으려면 문자열을 매개 변수로 허용하는 메서드의 Insert 다른 버전을 사용합니다.
컬렉션에서 특정 위치를 지정하지 않고 항목을 추가하려면 메서드를 Add 사용합니다. 컬렉션에 항목 배열을 추가하려면 메서드를 AddRange 사용합니다.
