ListView.ListViewItemCollection.Insert Método
Definição
Importante
Algumas informações dizem respeito a um produto pré-lançado que pode ser substancialmente modificado antes de ser lançado. A Microsoft não faz garantias, de forma expressa ou implícita, em relação à informação aqui apresentada.
Insere um item na coleção no índice especificado.
Sobrecargas
| Name | Description |
|---|---|
| Insert(Int32, String, String, String) |
Cria um novo item com a chave, texto e imagem especificados, e adiciona-o à coleção no índice especificado. |
| Insert(Int32, String, String, Int32) |
Cria um novo item com a chave, texto e 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 insere-o na coleção no índice especificado. |
| Insert(Int32, String, Int32) |
Cria um novo item com o índice de imagem especificado e insere-o na coleção no índice especificado. |
Insert(Int32, String, String, String)
Cria um novo item com a chave, texto e 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 onde o item é inserido.
- text
- String
O texto do artigo.
- imageKey
- String
A chave da imagem a mostrar para o item.
Devoluções
Eles ListViewItem acrescentaram à coleção.
Exceções
O index parâmetro é inferior a 0 ou superior ao valor da Count propriedade da ListView.ListViewItemCollection.
Observações
O Insert método define a Name propriedade do item para a chave especificada, para que o item possa ser recuperado pelo seu índice ou pela chave.
Aplica-se a
Insert(Int32, String, String, Int32)
Cria um novo item com a chave, texto e 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 onde o item é inserido.
- text
- String
O texto do artigo.
- imageIndex
- Int32
O índice da imagem a mostrar para o item.
Devoluções
Eles ListViewItem acrescentaram à coleção.
Exceções
O index parâmetro é inferior a 0 ou superior ao valor da Count propriedade da ListView.ListViewItemCollection.
Observações
O Insert método define a Name propriedade do item para a chave especificada, para que o item possa ser recuperado pelo seu índice ou pela 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 onde o item é inserido.
- text
- String
O texto do ListViewItem.
- imageKey
- String
A chave da imagem a mostrar para o item.
Devoluções
Eles ListViewItem acrescentaram à coleção.
Exceções
O index parâmetro é inferior a 0 ou superior ao valor da Count propriedade da 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 onde o item é inserido.
- item
- ListViewItem
O ListViewItem que representa o item a inserir.
Devoluções
Isso ListViewItem foi inserido na coleção.
Exceções
O index parâmetro é inferior a 0 ou superior ao valor da Count propriedade da ListView.ListViewItemCollection.
Observações
Esta versão do Insert método permite inserir um existente ListViewItem numa posição específica no ListView.ListViewItemCollection.
Note
Se a ListView.Sorting propriedade for definida para um valor diferente de SortOrder.None ou se a ListViewItemSorter propriedade estiver definida, a lista é ordenada após a inserção do item.
Para adicionar um item sem especificar uma posição específica na coleção para o adicionar, use o Add método. Se quiseres adicionar um conjunto de itens à coleção, usa o AddRange método. Pode usar este método se quiser inserir um novo item numa coleção já existente.
Ver também
Aplica-se a
Insert(Int32, String)
Cria um novo item e insere-o 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 onde o item é inserido.
- text
- String
O texto a mostrar para o item.
Devoluções
Isso ListViewItem foi inserido na coleção.
Exceções
O index parâmetro é inferior a 0 ou superior ao valor da Count propriedade da ListView.ListViewItemCollection.
Observações
Esta versão do Insert método permite inserir um novo item numa posição específica no ListView.ListViewItemCollection. O texto especificado no text parâmetro é usado para criar um novo ListViewItem que é depois inserido no ListView.ListViewItemCollection local especificado.
Note
Se a ListView.Sorting propriedade for definida para um valor diferente de SortOrder.None ou se a ListViewItemSorter propriedade estiver definida, a lista é ordenada 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 quiseres adicionar um conjunto de itens à coleção, usa o AddRange método. Pode usar este método se quiser inserir um novo item numa coleção já existente.
Ver também
Aplica-se a
Insert(Int32, String, Int32)
Cria um novo item com o índice de imagem especificado e insere-o 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 onde o item é inserido.
- text
- String
O texto a mostrar para o item.
- imageIndex
- Int32
O índice da imagem a mostrar para o item.
Devoluções
Isso ListViewItem foi inserido na coleção.
Exceções
O index parâmetro é inferior a 0 ou superior ao valor da Count propriedade da ListView.ListViewItemCollection.
Observações
Esta versão do Insert método permite inserir um novo item numa posição específica no ListView.ListViewItemCollection. O texto especificado no text parâmetro é usado para criar um novo ListViewItem que é depois inserido no ListView.ListViewItemCollection local especificado.
Note
Se a ListView.Sorting propriedade for definida para um valor diferente de SortOrder.None ou se a ListViewItemSorter propriedade estiver definida, a lista é ordenada após a inserção do item.
Também pode usar esta versão do Insert método para especificar uma imagem para o item, passando o índice atribuído ImageList às ListView.LargeImageList propriedades e ListView.SmallImageList para o imageIndex parâmetro. (Tipicamente, as ListView.LargeImageList propriedades e ListView.SmallImageList usam as mesmas posições de índice para exibir imagens relacionadas.) Se não quiser especificar um índice de imagem para o item, use a outra versão do Insert método que aceita uma string como parâmetro.
Para adicionar um item sem especificar uma posição específica na coleção, use o Add método. Se quiseres adicionar um conjunto de itens à coleção, usa o AddRange método.
