Comment ajouter des éléments dans une ListView en programmation

Le contrôle ListView permet d'afficher des informations sous différentes présentations. Une fois stockées dans la ListView, les données sont facilement manipulables.

Structure d'un élément ListView

Chaque ligne d'une ListView peut être définie en 2 parties: ListView1.ListItems(x) spécifie la ligne x et la 1ere colonne de cette ligne. colonnes adjacentes.

ListView1.ListItems.Add [Index], [Key], [Text], [Icon], [SmallIcon]

  • [Index]: Facultatif. ajouté la nouvel élément. l'argument n'est pas spécifié.
  • [Key]: Facultatif. Attribue une clé unique qui fiabilise l'identification des lignes.
  • [Text]: Facultatif. Indique le texte qui va s'afficher dans la ListView.
  • [Icon]: Facultatif. la ListView est en mode lvwIcon.
  • [SmallIcon]: Facultatif. Spécifie le numéro de ligne dans la ListView.

La valeur 1 correspond à la 2eme colonne d'une ListView. [ReportIcon]: Facultatif. Permet d'afficher un icône ou une image dans le sous élément spécifié. [TooltipText]: Facultatif.

Gestion des en-têtes de colonnes

[Index]: Facultatif[Key] Facultatif. Attribue une clé unique qui fiabilise l'identification des entêtes. [Text]: Facultatif. Spécifie le texte qui va s'afficher dans l'entête. [Width]: Facultatif. Spécifie la largeur de la colonne. La valeur par défaut est de 72 points.

Lire aussi: Modifier Activité Kbis Auto-Entrepreneur

[Alignment]: Facultatif. Spécifie l'alignement dans la colonne. lvwColumnLeft (Valeur par défaut), lvwColumnCenter, lvwColumnRight.

Items, SubItems et clés

d'une ListView (Items, SubItems, Entêtes de colonnes). La procédure renvoie une erreur si la clé n'existe pas dans la ListView. Vous pouvez aussi récupérer la clé d'une ligne. La procédure renvoie une chaine vide si aucune clé n'est attribuée.

Cette macro permet d'attribuer une clé au ListItem de la 2eme ligne. dèja pour cet élément, celle ci sera écrasée. puisque la clé doit être unique.

Options d'affichage et mise en forme

Vous pouvez ensuite indiquer le statut par défaut de la CheckBox. est cochée ou décochée. La mise en forme est modifiée (couleur bleue et en gras). La macro suivante spécifie que les données doivent être centrées dans la colonne créée.

Tri et événements

par défaut. propriété SortKey. L'index de la première colonne est 0. Cet exemple utilise l'évènement ColumnClick. de la colonne cliquée.

Lire aussi: INPI et Micro-Entreprise : Démarches

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’ajout de l’élément. Sinon, l’élément est inséré à la fin de la liste. Si la liste n’est pas triée, vous pouvez utiliser la Insert méthode pour insérer un élément dans une ListView position spécifique.

Ajouter des éléments en masse et performances

Pour ajouter un ensemble d’éléments au contrôle dans une seule opération, utilisez la AddRange méthode. Si vous souhaitez utiliser la Add méthode pour ajouter un grand nombre d’éléments au contrôle, utilisez les méthodes BeginUpdate et EndUpdate pour empêcher la ListView repeindre jusqu’à ce que tous les éléments soient ajoutés.

Variantes de la méthode Add (exemples .NET)

Vous pouvez utiliser cette version de la Add méthode pour créer une nouvelle ListViewItem version à ajouter au ListView contrôle. Le texte du nouveau ListViewItem ajouté au contrôle est basé sur le text paramètre.

Si vous souhaitez spécifier une image pour l’élément, utilisez la version de la Add méthode qui accepte un index d’image en tant que paramètre. Vous pouvez également spécifier une image pour l’élément en transmettant l’index de l’objet ImageList affecté aux propriétés ListView.LargeImageList et ListView.SmallImageList au imageIndex 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.)

Vous pouvez utiliser cette version de la Add méthode pour ajouter une version existante ListViewItem à la collection. Cette version de la Add méthode est généralement utilisée pour réutiliser des éléments à partir d’autres ListView contrôles ou si celle-ci ListViewItem a été créée manuellement avant de l’ajouter à la collection.

Lire aussi: Comment Calculer la TVA ?

public virtual System.Windows.Forms.ListViewItem Add(string? text, string? ... Si la ListView valeur est triée, l’élément est ajouté dans l’ordre correctement trié ; sinon, il est ajouté à la fin de la collection.

Sélection et interaction utilisateur

Ensuite sélectionnez les lignes en gardant enfoncée la touche Ctrl. La première ligne est toujours sélectionnée par défaut lors de l'initialisation.

Images et icônes

Des images ou îcones peuvent être associés aux lignes du contrôle. propriétés.

Exemples pratiques et analogies

Ce premier exemple montre le principe de remplissage d'une Listview.

On utilise La méthode append() dans Python pour ajouter un élément à la fin d’une Python List existante. La méthode append() permet d’ajouter un élément à la fin d’une liste existante. L’élément à ajouter peut prendre la forme de tout type de donnée. Dans cet exemple, liste est le nom de la liste et element re­pré­sente l’élément à ajouter.

Comme on peut le voir, append() permet d’ajouter un élément de n’importe quel type de données à une liste en Python. Il est possible de saisir di­rec­te­ment l’élément à ajouter comme paramètre, soit de le créer au préalable comme variable avant de l’ajouter à la liste.

Au lieu d’ajouter les éléments de liste2 à l’autre liste, la méthode a sim­ple­ment ajouté liste2 elle-même comme élément unique. Le résultat est une liste imbriquée, ce qui n’est pas le but recherché. Cette solution n’est pas des plus es­thé­tiques.

Bien que la méthode Pyton append() soit le plus souvent utilisée pour la gestion de listes, elle peut aussi s’appliquer à d’autres struc­tures de données courantes sous Python. Les Arrays Python ne font pas partie de la bi­blio­thèque standard de Python et doivent être importés d’un module externe comme numpy ou array.

Si vous cherchez à gérer ef­fi­ca­ce­ment l’espace mémoire et la puissance de calcul, ces tableaux cons­ti­tuent un meilleur choix que les listes. En revanche, les tableaux sont un peu plus limités : ils ne peuvent contenir que des éléments de données de même type. Le type de données est défini à la création du tableau.

Il est ainsi im­pos­sible d’ajouter des éléments de types de données dif­fé­rents à un tableau avec la méthode append(). Enfin, il est important de men­tion­ner que les tableaux ont une longueur fixe, dé­ter­mi­née à la création de la structure de données. Il est im­pos­sible de modifier cette structure par la suite.

Comme pour les listes et les tableaux, il existe une méthode append() pour les struc­tures de données Deque avec un com­por­te­ment très similaire. Une « Deque » (prononcer « Dèque », abré­via­tion de l’anglais double-ended queue) est une liste dans laquelle on peut ajouter ou supprimer des éléments aussi bien à la fin qu’au début. Ici, la méthode append() se comporte de la même manière que pour une liste. Il existe cependant une méthode sup­plé­men­taire, ap­pend­left().

Les ListView et ItemTemplate en wpf

Bonnes pratiques lors de l'ajout d'éléments

  1. Utiliser BeginUpdate/EndUpdate lors d'insertion massive pour éviter le repaint et améliorer les performances.
  2. Si vous devez conserver un ordre particulier, régler la propriété Sorting ou utiliser Insert pour une position précise.
  3. Attribuer des clés uniques ([Key]) si vous devez récupérer ou modifier des éléments par référence plutôt que par index.
  4. Associer des images via ImageList et utiliser les index d'images cohérents entre LargeImageList et SmallImageList.
  5. Gérer les SubItems pour remplir les colonnes adjacentes et contrôler l'alignement et la largeur des colonnes.

Tableau récapitulatif des paramètres courants

ParamètreTypeRôle
IndexFacultatifPosition d'insertion; si non spécifié, élément ajouté en fin
KeyFacultatifClé unique pour identifier une ligne
TextFacultatifTexte affiché dans la colonne principale
Icon / SmallIconFacultatifIndex d'image à associer à l'élément
WidthFacultatifLargeur de colonne (défaut 72 points)
AlignmentFacultatifAlignement: lvwColumnLeft, lvwColumnCenter, lvwColumnRight

Vous avez aimé ce tutoriel ? Certaines informations portent sur la préversion du produit qui est susceptible d’être en grande partie modifiée avant sa publication.

balises:

Articles populaires: