ListView.ListViewItemCollection.Insert Método

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

Retornos

O ListViewItem adicionado à coleção.

Exceções

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.

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

Retornos

O ListViewItem adicionado à coleção.

Exceções

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.

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

Retornos

O ListViewItem adicionado à coleção.

Exceções

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

Retornos

O ListViewItem que foi inserido na coleção.

Exceções

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.

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[])

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

Retornos

O ListViewItem que foi inserido na coleção.

Exceções

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.

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[])

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

Retornos

O ListViewItem que foi inserido na coleção.

Exceções

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.

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[])