Compartilhar via


ListView.ListViewItemCollection.Insert Método

Definição

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

O ListViewItem adicionado à coleção.

Exceções

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.

Aplica-se a

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

O ListViewItem adicionado à coleção.

Exceções

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.

Aplica-se a

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

O ListViewItem adicionado à coleção.

Exceções

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

Aplica-se a

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

O ListViewItem que foi inserido na coleção.

Exceções

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

Aplica-se a

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

O ListViewItem que foi inserido na coleção.

Exceções

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

Aplica-se a

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

O ListViewItem que foi inserido na coleção.

Exceções

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

Aplica-se a