Vcl.StdCtrls.TCustomListBox
Delphi
TCustomListBox = class(TCustomMultiSelectListControl)
C++
class PASCALIMPLEMENTATION TCustomListBox : public Vcl::Controls::TCustomMultiSelectListControl
Propriétés
| Type | Visibilité | Source | Unité | Parent |
|---|---|---|---|---|
| class | public | Vcl.StdCtrls.pas Vcl.StdCtrls.hpp |
Vcl.StdCtrls | Vcl.StdCtrls |
Description
TCustomListBox est la classe de base des objets boîte liste qui encapsule les contrôles boîte liste.
TCustomListBox encapsule les comportements communs à tous les contrôles boîte liste. Les objets boîte liste sont utilisés pour afficher une liste défilante dans laquelle les utilisateurs peuvent sélectionner un ou plusieurs éléments. Utilisez un contrôle boîte liste pour imposer à l'utilisateur la sélection d'une valeur dans une liste d'éléments. Les éléments peuvent être ajoutés à la conception ou à l'exécution.
Comme encapsulation d'une boîte liste, TCustomListBox introduit des méthodes pour :
Afficher, trier, sélectionner, manipuler et interroger les éléments de la liste.
Créer des listes dessinées par l'utilisateur pouvant afficher des images comme des icônes ou des bitmaps.
Créer des listes multicolonnes ou à sélection multiple.
Par défaut, TCustomListBox est une boîte liste standard qui affiche les éléments comme des chaînes de texte. Ces éléments sont contenus dans un objet TStrings. Les méthodes de l'objet TStrings sont utilisées pour ajouter, insérer ou supprimer une chaîne. Le code suivant illustre l'ajout d'une nouvelle chaîne à la boîte liste :
MyListBox.Items.Add('Nouvel élément'); // Delphi
MyListBox->Items->Add("Nouvel élément"); // C++
Les descendants de TCustomListBox héritent des fonctionnalités de base de TCustomListBox. Certains descendants ont des comportements spécialisés et peuvent être liés à des informations concernant des fichiers, des répertoires, des disques ou des bases de données. Utilisez ces boîtes liste pour accéder facilement à ce type d'information.
Une boîte à options est une boîte liste avec un contrôle de saisie, la liste ayant, de manière facultative, le style déroulant. Utilisez une boîte à options pour permettre aux utilisateurs de saisir une valeur dans la boîte de saisie, ou d'ouvrir la liste déroulante, ce qui économise de l'espace dans la fiche.
Pour les listes d'éléments nécessitant une structure de matrice ou d'arborescence, utilisez les vues liste ou les vues arborescentes. Ces contrôles permettent de regrouper les éléments dans des en-têtes de colonne ou dans des lignes extensibles ou réductibles.