ListView.ListViewItemCollection.Insert Método

Definição

Namespace:

System.Windows.Forms

Assembly:

System.Windows.Forms.dll

Insere um item na coleção no índice especificado.

Sobrecargas

Insert(Int32, String, String, String)	Cria um novo item com a chave, a imagem e o texto especificados e o adiciona à coleção, no índice especificado.
Insert(Int32, String, String, Int32)	Cria um novo item com a chave, a imagem e o texto especificados e o insere na coleção, no índice especificado.
Insert(Int32, String, String)	Cria um novo item com a imagem e o texto especificados e o insere na coleção, no índice especificado.
Insert(Int32, ListViewItem)	Insere um ListViewItem existente na coleção no índice especificado.
Insert(Int32, String)	Cria um novo item e o insere na coleção no índice especificado.
Insert(Int32, String, Int32)	Cria um novo item com o índice de imagem especificado e o insere na coleção, no índice especificado.

Insert(Int32, String, String, String)

Cria um novo item com a chave, a imagem e o texto especificados e o adiciona à coleção, no índice especificado.

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

Parâmetros

index

Int32

O local do índice de base zero no qual o item é inserido.

key

String

O Name do item.

text

String

O texto do item.

imageKey

String

A chave da imagem a ser exibida para o item.

Retornos

ListViewItem

O ListViewItem adicionado à coleção.

Exceções

ArgumentOutOfRangeException

O parâmetro index é menor que 0 ou maior que o valor da propriedade Count do ListView.ListViewItemCollection.

Comentários

O Insert método define a Name propriedade do item como a chave especificada, para que o item possa ser recuperado por seu índice ou por chave.

Insert(Int32, String, String, Int32)

Cria um novo item com a chave, a imagem e o texto especificados e o insere na coleção, no índice especificado.

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

Parâmetros

index

Int32

O local do índice de base zero no qual o item é inserido.

key

String

O Name do item.

text

String

O texto do item.

imageIndex

Int32

O índice da imagem a ser exibida para o item.

Retornos

ListViewItem

O ListViewItem adicionado à coleção.

Exceções

ArgumentOutOfRangeException

O parâmetro index é menor que 0 ou maior que o valor da propriedade Count do ListView.ListViewItemCollection.

Comentários

O Insert método define a Name propriedade do item como a chave especificada, para que o item possa ser recuperado por seu índice ou por chave.

Insert(Int32, String, String)

Cria um novo item com a imagem e o texto especificados e o insere na coleção, no índice especificado.

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

Parâmetros

index

Int32

O local do índice de base zero no qual o item é inserido.

text

String

O texto do ListViewItem.

imageKey

String

A chave da imagem a ser exibida para o item.

Retornos

ListViewItem

O ListViewItem adicionado à coleção.

Exceções

ArgumentOutOfRangeException

O parâmetro index é menor que 0 ou maior que o valor da propriedade Count do ListView.ListViewItemCollection.

Insert(Int32, ListViewItem)

Insere um ListViewItem existente na coleção no índice especificado.

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

Parâmetros

index

Int32

O local do índice de base zero no qual o item é inserido.

item

ListViewItem

Um ListViewItem que representa o item a ser inserido.

Retornos

ListViewItem

O ListViewItem que foi inserido na coleção.

Exceções

ArgumentOutOfRangeException

O parâmetro index é menor que 0 ou maior que o valor da propriedade Count do ListView.ListViewItemCollection.

Comentários

Essa versão do Insert método permite que você insira um existente ListViewItem em uma posição específica no ListView.ListViewItemCollection.

Observação

Se a ListView.Sorting propriedade for definida como um valor diferente SortOrder.None de ou se a ListViewItemSorter propriedade estiver definida, a lista será classificada depois que o item for inserido.

Para adicionar um item sem especificar uma posição específica na coleção para adicionar o item, use o Add método . Se você quiser adicionar uma matriz de itens à coleção, use o AddRange método . Você pode usar esse método se quiser inserir um novo item em uma coleção existente de itens.

Confira também

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

Insert(Int32, String)

Cria um novo item e o insere na coleção no índice especificado.

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

Parâmetros

index

Int32

O local do índice de base zero no qual o item é inserido.

text

String

O texto a ser exibido para o item.

Retornos

ListViewItem

O ListViewItem que foi inserido na coleção.

Exceções

ArgumentOutOfRangeException

O parâmetro index é menor que 0 ou maior que o valor da propriedade Count do ListView.ListViewItemCollection.

Comentários

Essa versão do Insert método permite que você insira um novo item em uma posição específica no ListView.ListViewItemCollection. O texto especificado no parâmetro é usado para criar um novo ListViewItem que, em text seguida, é inserido ListView.ListViewItemCollection no no local especificado.

Observação

Se a ListView.Sorting propriedade for definida como um valor diferente SortOrder.None de ou se a ListViewItemSorter propriedade estiver definida, a lista será classificada depois que o item for inserido.

Para adicionar um item sem especificar uma posição específica na coleção, use o Add método . Se você quiser adicionar uma matriz de itens à coleção, use o AddRange método . Você pode usar esse método se quiser inserir um novo item em uma coleção existente de itens.

Confira também

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

Insert(Int32, String, Int32)

Cria um novo item com o índice de imagem especificado e o insere na coleção, no índice especificado.

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

Parâmetros

index

Int32

O local do índice de base zero no qual o item é inserido.

text

String

O texto a ser exibido para o item.

imageIndex

Int32

O índice da imagem a ser exibida para o item.

Retornos

ListViewItem

O ListViewItem que foi inserido na coleção.

Exceções

ArgumentOutOfRangeException

O parâmetro index é menor que 0 ou maior que o valor da propriedade Count do ListView.ListViewItemCollection.

Comentários

Essa versão do Insert método permite que você insira um novo item em uma posição específica no ListView.ListViewItemCollection. O texto especificado no parâmetro é usado para criar um novo ListViewItem que, em text seguida, é inserido ListView.ListViewItemCollection no no local especificado.

Observação

Se a ListView.Sorting propriedade for definida como um valor diferente SortOrder.None de ou se a ListViewItemSorter propriedade estiver definida, a lista será classificada depois que o item for inserido.

Você também pode usar essa versão do Insert método para especificar uma imagem para o item passando o índice do ImageList atribuído às ListView.LargeImageList propriedades e ListView.SmallImageList para o imageIndex parâmetro . (Normalmente, as ListView.LargeImageList propriedades e ListView.SmallImageList usam as mesmas posições de índice para exibir imagens relacionadas.) Se você não quiser especificar um índice de imagem para o item, use a outra versão do Insert método que aceita uma cadeia de caracteres como um parâmetro.

Para adicionar um item sem especificar uma posição específica na coleção, use o Add método . Se você quiser adicionar uma matriz de itens à coleção, use o AddRange método .

Confira também

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