Liaison d'une propriété d'un composant à un champ
Remonter à Expert LiveBindings
Cette procédure montre comment lier une propriété d'un composant à un champ d'un ensemble de données, par le biais de l'expert LiveBindings.
Sommaire
Commencez par créer une application HD multi-périphérique, puis placez un contrôle TLabel et un ensemble de données client sur la fiche. Vous apprendrez comment lier la propriété Text du libellé à un champ textuel du fichier de données qui est transmis à l'ensemble de données.
Remarque : Pour que cette procédure fonctionne, la base de données biolife.cds doit typiquement :
- être installée dans le répertoire /Data accessible via Démarrer | Programmes | Embarcadero RAD Studio 10.1 Berlin | Exemples ;
- se trouver dans le référentiel Subversion pour les exemples sur SourceForge à l'adresse http://sourceforge.net/p/radstudiodemos/code/HEAD/tree/branches/RADStudio_Berlin/Data.
Notez que la base de données biolife.fds est une base de données FireDAC qui peut nécessiter différentes étapes.Un exemple de code qui utilise une base de données similaire (DBDEMOS) est situé dans l'exemple FishFact (Delphi).
Un tutoriel LiveBindings similaire est aussi disponible : Tutoriel : Utilisation de LiveBindings pour créer une application sans code.
Conseil : Afin que l'expert LiveBindings soit disponible dans le menu contextuel accessible par clic droit, vous devez l'activer dans Outils > Options > LiveBindings en sélectionnant "Afficher l'expert LiveBindings dans le menu contextuel". (Si vous démarrez l'expert depuis le Concepteur LiveBindings, vous n'avez alors pas besoin d'activer la commande Expert dans la boîte de dialogue Options.)
Etape 1 : Tâche de liaison
Dès que vous avez placé le contrôle libellé sur la fiche, vous devez le lier au champ Category de l'ensemble de données.
Cliquez d'abord sur le composant ensemble de données client, puis dans l'inspecteur d'objets, localisez la propriété FileName. Spécifiez l'emplacement de la base de données biolife.cds.
Localisez la propriété Active dans l'inspecteur d'objets et définissez-la sur True.
Cliquez avec le bouton droit sur le contrôle image et sélectionnez la commande Expert LiveBindings.
Sélectionnez ensuite Lier une propriété de Label1 à un champ dans la page Tâche de liaison de l'expert.
Validez votre sélection en cliquant sur le bouton Suivant.
Etape 2 : Propriété de composant
Vous êtes maintenant invité à sélectionner le composant et la propriété auxquels vous voulez lier votre libellé.
Dans la zone de liste déroulante Composant, sélectionnez Label1.
Dans la zone de liste déroulante Propriété, sélectionnez Text, puisque vous voulez lier le libellé au champ texte Category.
Cliquez sur Suivant.
Etape 3 : Source de données
Vous devez sélectionner ici l'ensemble de données depuis l'onglet Source existante. Choisissez ClientDataSet1.
Cliquez sur Suivant.
Etape 4 : Champ
La liste des champs disponibles de la base de données biolife.cds est maintenant présentée.
Sélectionnez le champ Category.
Cliquez sur Suivant.
Etape 5 : Options
Vous êtes invité à préciser si vous voulez créer un navigateur de source de données avec votre expression de liaison.
Pour cet exemple, choisissez d'ajouter un navigateur.
Cliquez sur Terminer car c'est la dernière page de l'expert.
Dès que l'expert est fermé, une nouvelle expression de liaison est créée. Elle lie la propriété Text du contrôle image et le champ Category de l'ensemble de données spécifié.
Les résultats
Dès que l'expert est fermé et que vous revenez dans le concepteur de l'EDI, vous constatez que deux nouveaux composants associés au moteur LiveBindings ont été ajoutés (TBindingsList et TBindScopeDB) ainsi qu'un composant TBindNavigator. Pour afficher la boîte de dialogue Editeur d'expressions de liaison, double-cliquez sur le composant BindingsList1.
Exécutez maintenant l'application (appuyez sur F9) et testez votre expression de liaison en parcourant les enregistrements de l'ensemble de données. Vous devriez constater que le texte du libellé est mis à jour correctement.
Un écran représentant l'exécution de l'application est affiché ci-dessous.