ListView.ListViewItemCollection.Insert Méthode
Définition
Important
Certaines informations portent sur la préversion du produit qui est susceptible d’être en grande partie modifiée avant sa publication. Microsoft exclut toute garantie, expresse ou implicite, concernant les informations fournies ici.
Insère un élément dans la collection à l’index spécifié.
Surcharges
| Nom | Description |
|---|---|
| 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 un existant ListViewItem dans la collection à l’index spécifié. |
| Insert(Int32, String) |
Crée un élément et l’insère dans la collection à l’index spécifié. |
| Insert(Int32, String, Int32) |
Crée un élément avec 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.ListViewItemPublic Overridable Function Insert (index As Integer, key As String, text As String, imageKey As String) As ListViewItemParamètres
- index
- Int32
Emplacement d’index de base zéro où l’élément est inséré.
- text
- String
Texte de l’élément.
- imageKey
- String
Clé de l’image à afficher pour l’élément.
Retours
Ajouté ListViewItem à la collection.
Exceptions
Le index paramètre est inférieur à 0 ou supérieur à la valeur de la Count propriété du 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.ListViewItemPublic Overridable Function Insert (index As Integer, key As String, text As String, imageIndex As Integer) As ListViewItemParamètres
- index
- Int32
Emplacement d’index de base zéro où l’élément est inséré.
- text
- String
Texte de l’élément.
- imageIndex
- Int32
Index de l’image à afficher pour l’élément.
Retours
Ajouté ListViewItem à la collection.
Exceptions
Le index paramètre est inférieur à 0 ou supérieur à la valeur de la Count propriété du 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.ListViewItemPublic Function Insert (index As Integer, text As String, imageKey As String) As ListViewItemParamètres
- index
- Int32
Emplacement d’index de base zéro où l’élément est inséré.
- text
- String
Texte du ListViewItem.
- imageKey
- String
Clé de l’image à afficher pour l’élément.
Retours
Ajouté ListViewItem à la collection.
Exceptions
Le index paramètre est inférieur à 0 ou supérieur à la valeur de la Count propriété du ListView.ListViewItemCollection.
S’applique à
Insert(Int32, ListViewItem)
Insère un existant ListViewItem dans la collection à 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.ListViewItemPublic Function Insert (index As Integer, item As ListViewItem) As ListViewItemParamètres
- index
- Int32
Emplacement d’index de base zéro où l’élément est inséré.
- item
- ListViewItem
Qui ListViewItem représente l’élément à insérer.
Retours
Qui ListViewItem a été inséré dans la collection.
Exceptions
Le index paramètre est inférieur à 0 ou supérieur à la valeur de la Count propriété du 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.
Note
Si la ListView.Sorting propriété est définie sur une valeur autre que SortOrder.None ou si la propriété est définie, la ListViewItemSorter 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 pour 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 existante d’éléments.
Voir aussi
S’applique à
Insert(Int32, String)
Crée un é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.ListViewItemPublic Function Insert (index As Integer, text As String) As ListViewItemParamètres
- index
- Int32
Emplacement d’index de base zéro où l’élément est inséré.
- text
- String
Texte à afficher pour l’élément.
Retours
Qui ListViewItem a été inséré dans la collection.
Exceptions
Le index paramètre est inférieur à 0 ou supérieur à la valeur de la Count propriété du 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 l’emplacement ListView.ListViewItemCollection spécifié.
Note
Si la ListView.Sorting propriété est définie sur une valeur autre que SortOrder.None ou si la propriété est définie, la ListViewItemSorter 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 existante d’éléments.
Voir aussi
S’applique à
Insert(Int32, String, Int32)
Crée un élément avec 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.ListViewItemPublic Function Insert (index As Integer, text As String, imageIndex As Integer) As ListViewItemParamètres
- index
- Int32
Emplacement d’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
Qui ListViewItem a été inséré dans la collection.
Exceptions
Le index paramètre est inférieur à 0 ou supérieur à la valeur de la Count propriété du 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 l’emplacement ListView.ListViewItemCollection spécifié.
Note
Si la ListView.Sorting propriété est définie sur une valeur autre que SortOrder.None ou si la propriété est définie, la ListViewItemSorter 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 de l’objet ImageList affecté aux propriétés imageIndex et ListView.SmallImageList au ListView.LargeImageList paramètre. (En règle générale, les ListView.LargeImageList propriétés 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 en tant que 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.
