ListView.ListViewItemCollection.Insert Método
Definição
Importante
Algumas informações se referem a produtos de pré-lançamento que podem ser substancialmente modificados antes do lançamento. A Microsoft não oferece garantias, expressas ou implícitas, das informações aqui fornecidas.
Insere um item na coleção no índice especificado.
Sobrecargas
| Nome | Description |
|---|---|
| Insert(Int32, String, String, String) |
Cria um novo item com a chave, o texto e a imagem especificados e adiciona-o à coleção no índice especificado. |
| Insert(Int32, String, String, Int32) |
Cria um novo item com a chave, o texto e a imagem especificados e insere-o na coleção no índice especificado. |
| Insert(Int32, String, String) |
Cria um novo item com o texto e a imagem especificados e insere-o na coleção no índice especificado. |
| Insert(Int32, ListViewItem) |
Insere um existente ListViewItem 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, o texto e a imagem especificados e adiciona-o à 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.ListViewItemPublic Overridable Function Insert (index As Integer, key As String, text As String, imageKey As String) As ListViewItemParâmetros
- index
- Int32
O local do índice baseado em zero em que o item é inserido.
- 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 index parâmetro é menor que 0 ou maior que o valor da Count propriedade do ListView.ListViewItemCollection.
Comentários
O Insert método define a Name propriedade do item como a chave especificada, de modo 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, o texto e a imagem especificados e insere-o 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.ListViewItemPublic Overridable Function Insert (index As Integer, key As String, text As String, imageIndex As Integer) As ListViewItemParâmetros
- index
- Int32
O local do índice baseado em zero em que o item é inserido.
- 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 index parâmetro é menor que 0 ou maior que o valor da Count propriedade do ListView.ListViewItemCollection.
Comentários
O Insert método define a Name propriedade do item como a chave especificada, de modo que o item possa ser recuperado por seu índice ou por chave.
Aplica-se a
Insert(Int32, String, String)
Cria um novo item com o texto e a imagem especificados e insere-o 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.ListViewItemPublic Function Insert (index As Integer, text As String, imageKey As String) As ListViewItemParâmetros
- index
- Int32
O local do índice baseado em zero em que 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 index parâmetro é menor que 0 ou maior que o valor da Count propriedade do ListView.ListViewItemCollection.
Aplica-se a
Insert(Int32, ListViewItem)
Insere um existente ListViewItem 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.ListViewItemPublic Function Insert (index As Integer, item As ListViewItem) As ListViewItemParâmetros
- index
- Int32
O local do índice baseado em zero em que o item é inserido.
- item
- ListViewItem
O ListViewItem que representa o item a ser inserido.
Retornos
O ListViewItem que foi inserido na coleção.
Exceções
O index parâmetro é menor que 0 ou maior que o valor da Count propriedade 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 ou se a ListViewItemSorter propriedade estiver definida, a lista será classificada após a inserção do item.
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.ListViewItemPublic Function Insert (index As Integer, text As String) As ListViewItemParâmetros
- index
- Int32
O local do índice baseado em zero em que 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 index parâmetro é menor que 0 ou maior que o valor da Count propriedade do ListView.ListViewItemCollection.
Comentários
Esta 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 text parâmetro é usado para criar um novo ListViewItem inserido ListView.ListViewItemCollection no local especificado.
Observação
Se a ListView.Sorting propriedade for definida como um valor diferente SortOrder.None ou se a ListViewItemSorter propriedade estiver definida, a lista será classificada após a inserção do item.
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.ListViewItemPublic Function Insert (index As Integer, text As String, imageIndex As Integer) As ListViewItemParâmetros
- index
- Int32
O local do índice baseado em zero em que 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 index parâmetro é menor que 0 ou maior que o valor da Count propriedade do ListView.ListViewItemCollection.
Comentários
Esta 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 text parâmetro é usado para criar um novo ListViewItem inserido ListView.ListViewItemCollection no local especificado.
Observação
Se a ListView.Sorting propriedade for definida como um valor diferente SortOrder.None ou se a ListViewItemSorter propriedade estiver definida, a lista será classificada após a inserção do item.
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 ao ListView.LargeImageList parâmetro e ListView.SmallImageList as propriedades imageIndex . (Normalmente, as propriedades e ListView.SmallImageList as ListView.LargeImageList propriedades 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.
