Partager via


ListView.ListViewItemCollection.Insert Méthode

Définition

Insère un élément dans la collection au niveau de l'index spécifié.

Surcharges

Insert(Int32, String, String, String)

Crée un élément avec la clé, le texte et l'image spécifiés, et l'ajoute à la collection à l'index spécifié.

Insert(Int32, String, String, Int32)

Crée un élément avec la clé, le texte et l'image spécifiés, et l'insère dans la collection à l'index spécifié.

Insert(Int32, String, String)

Crée un élément avec le texte et l'image spécifiés, et l'insère dans la collection à l'index spécifié.

Insert(Int32, ListViewItem)

Insère dans la collection un ListViewItem existant à l'index spécifié.

Insert(Int32, String)

Crée un nouvel élément et l'insère dans la collection à l'index spécifié.

Insert(Int32, String, Int32)

Crée un nouvel élément muni de l'index d'image spécifié et l'insère dans la collection à l'index spécifié.

Insert(Int32, String, String, String)

Crée un élément avec la clé, le texte et l'image spécifiés, et l'ajoute à la collection à l'index spécifié.

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

Paramètres

index
Int32

Emplacement de l’index de base zéro où l’élément est inséré.

key
String

Name de l'élément.

text
String

Le texte de l'élément.

imageKey
String

Clé de l'image à afficher pour l'élément.

Retours

ListViewItem ajouté à la collection.

Exceptions

Le paramètre index est inférieur à 0 ou supérieur à la valeur de la propriété Count de ListView.ListViewItemCollection.

Remarques

La Insert méthode définit la Name propriété de l’élément sur la clé spécifiée, afin que l’élément puisse être récupéré par son index ou par clé.

S’applique à

Insert(Int32, String, String, Int32)

Crée un élément avec la clé, le texte et l'image spécifiés, et l'insère dans la collection à l'index spécifié.

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

Paramètres

index
Int32

Emplacement de l’index de base zéro où l’élément est inséré.

key
String

Name de l'élément.

text
String

Le texte de l'élément.

imageIndex
Int32

Index de l'image à afficher pour l'élément.

Retours

ListViewItem ajouté à la collection.

Exceptions

Le paramètre index est inférieur à 0 ou supérieur à la valeur de la propriété Count de ListView.ListViewItemCollection.

Remarques

La Insert méthode définit la Name propriété de l’élément sur la clé spécifiée, afin que l’élément puisse être récupéré par son index ou par clé.

S’applique à

Insert(Int32, String, String)

Crée un élément avec le texte et l'image spécifiés, et l'insère dans la collection à l'index spécifié.

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

Paramètres

index
Int32

Emplacement de l’index de base zéro où l’élément est inséré.

text
String

Texte de ListViewItem.

imageKey
String

Clé de l'image à afficher pour l'élément.

Retours

ListViewItem ajouté à la collection.

Exceptions

Le paramètre index est inférieur à 0 ou supérieur à la valeur de la propriété Count de ListView.ListViewItemCollection.

S’applique à

Insert(Int32, ListViewItem)

Insère dans la collection un ListViewItem existant à l'index spécifié.

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

Paramètres

index
Int32

Emplacement de l’index de base zéro où l’élément est inséré.

item
ListViewItem

ListViewItem représentant l'élément à insérer.

Retours

ListViewItem inséré dans la collection.

Exceptions

Le paramètre index est inférieur à 0 ou supérieur à la valeur de la propriété Count de ListView.ListViewItemCollection.

Remarques

Cette version de la Insert méthode vous permet d’insérer un existant ListViewItem à une position spécifique dans le ListView.ListViewItemCollection.

Notes

Si la ListView.Sorting propriété est définie sur une valeur autre que SortOrder.None ou si la ListViewItemSorter propriété est définie, la liste est triée après l’insertion de l’élément.

Pour ajouter un élément sans spécifier de position spécifique dans la collection à ajouter à l’élément, utilisez la Add méthode . Si vous souhaitez ajouter un tableau d’éléments à la collection, utilisez la AddRange méthode . Vous pouvez utiliser cette méthode si vous souhaitez insérer un nouvel élément dans une collection d’éléments existante.

Voir aussi

S’applique à

Insert(Int32, String)

Crée un nouvel élément et l'insère dans la collection à l'index spécifié.

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

Paramètres

index
Int32

Emplacement de l’index de base zéro où l’élément est inséré.

text
String

Texte à afficher pour l'élément.

Retours

ListViewItem inséré dans la collection.

Exceptions

Le paramètre index est inférieur à 0 ou supérieur à la valeur de la propriété Count de ListView.ListViewItemCollection.

Remarques

Cette version de la Insert méthode vous permet d’insérer un nouvel élément à une position spécifique dans le ListView.ListViewItemCollection. Le texte spécifié dans le text paramètre est utilisé pour créer un nouveau ListViewItem qui est ensuite inséré dans le ListView.ListViewItemCollection à l’emplacement spécifié.

Notes

Si la ListView.Sorting propriété est définie sur une valeur autre que SortOrder.None ou si la ListViewItemSorter propriété est définie, la liste est triée après l’insertion de l’élément.

Pour ajouter un élément sans spécifier de position spécifique dans la collection, utilisez la Add méthode . Si vous souhaitez ajouter un tableau d’éléments à la collection, utilisez la AddRange méthode . Vous pouvez utiliser cette méthode si vous souhaitez insérer un nouvel élément dans une collection d’éléments existante.

Voir aussi

S’applique à

Insert(Int32, String, Int32)

Crée un nouvel élément muni de l'index d'image spécifié et l'insère dans la collection à l'index spécifié.

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

Paramètres

index
Int32

Emplacement de l’index de base zéro où l’élément est inséré.

text
String

Texte à afficher pour l'élément.

imageIndex
Int32

Index de l'image à afficher pour l'élément.

Retours

ListViewItem inséré dans la collection.

Exceptions

Le paramètre index est inférieur à 0 ou supérieur à la valeur de la propriété Count de ListView.ListViewItemCollection.

Remarques

Cette version de la Insert méthode vous permet d’insérer un nouvel élément à une position spécifique dans le ListView.ListViewItemCollection. Le texte spécifié dans le text paramètre est utilisé pour créer un nouveau ListViewItem qui est ensuite inséré dans le ListView.ListViewItemCollection à l’emplacement spécifié.

Notes

Si la ListView.Sorting propriété est définie sur une valeur autre que SortOrder.None ou si la ListViewItemSorter propriété est définie, la liste est triée après l’insertion de l’élément.

Vous pouvez également utiliser cette version de la Insert méthode pour spécifier une image pour l’élément en passant l’index du ImageList affecté aux ListView.LargeImageList propriétés et ListView.SmallImageList au imageIndex paramètre . (En règle générale, les ListView.LargeImageList propriétés et ListView.SmallImageList utilisent les mêmes positions d’index pour afficher les images associées.) Si vous ne souhaitez pas spécifier d’index d’image pour l’élément, utilisez l’autre version de la Insert méthode qui accepte une chaîne comme paramètre.

Pour ajouter un élément sans spécifier de position spécifique dans la collection, utilisez la Add méthode . Si vous souhaitez ajouter un tableau d’éléments à la collection, utilisez la AddRange méthode .

Voir aussi

S’applique à