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
| 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.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 de base zero no qual 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 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.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 de base zero no qual 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 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.ListViewItemPublic Function Insert (index As Integer, text As String, imageKey As String) As ListViewItemParâ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.ListViewItemPublic Function Insert (index As Integer, item As ListViewItem) As ListViewItemParâ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.ListViewItemPublic Function Insert (index As Integer, text As String) As ListViewItemParâ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.ListViewItemPublic Function Insert (index As Integer, text As String, imageIndex As Integer) As ListViewItemParâ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
Comentários
Em breve: Ao longo de 2024, eliminaremos os problemas do GitHub como o mecanismo de comentários para conteúdo e o substituiremos por um novo sistema de comentários. Para obter mais informações, consulte https://aka.ms/ContentUserFeedback.
Enviar e exibir comentários de