API:Vcl.CheckLst.TCheckListBox

De RAD Studio API Documentation
Aller à : navigation, rechercher

Vcl.CheckLst.TCustomCheckListBoxVcl.StdCtrls.TCustomListBoxVcl.Controls.TCustomMultiSelectListControlVcl.Controls.TCustomListControlVcl.Controls.TWinControlTCheckListBox

Delphi

TCheckListBox = class(TCustomCheckListBox)

C++

class PASCALIMPLEMENTATION TCheckListBox : public TCustomCheckListBox

Propriétés

Type Visibilité  Source Unité  Parent
class public
Vcl.CheckLst.pas
Vcl.CheckLst.hpp
Vcl.CheckLst Vcl.CheckLst

Description


TCustomListBox est la classe de base des objets boîte liste qui encapsule les contrôles boîte liste.

Vcl.CheckLst.TCheckListBox hérite de Vcl.StdCtrls.TCustomListBox. Tout le contenu en-dessous de cette ligne se réfère à Vcl.StdCtrls.TCustomListBox.

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.

Voir aussi