This page is also available in

Documentation

La documentation ci-dessous fait partie de la distribution de BeeBase. Elle est également disponible sous forme de PDF.

[ << ]

[ >> ]

[Sommaire]

[Table des matières]

[Index]

[ ? ]

15. Éditeur de structure

BeeBase dispose de deux modes de fonctionnement différents : le mode édition d'enregistrement où il est possible de saisir et parcourir les enregistrements, et le mode édition de structure où se définit la structure de la base, c'est à dire les tables, les champs et l'apparence d'un projet. Ce chapitre décrit l'éditeur de structure et explique comment gérer la structure d'un projet.

Pour basculer du mode édition d'enregistrement à celui d'édition de structure, il faut sélectionner l'élément `Éditeur de structure' dans le menu `Projet', ce qui ferme toutes les fenêtres et ouvre la fenêtre de l'éditeur de structure. Pour revenir au mode édition d'enregistrement, il faut sélectionner le menu `Projet - Fermer l'éditeur de structure' ou simplement fermer l'éditeur de structure en cliquant sur le gadget de fermeture dans la barre de titre de la fenêtre.

La fenêtre de l'éditeur de structure est divisée en trois parties : la partie supérieure gauche composée du groupe `Tables' servant à gérer les tables du projet, la partie inférieure gauche quant à elle occupée par le groupe `Champs' permet de gérer les champs d'une table, et pour finir la partie droite est occupée par un groupe `Affichage' pour gérer les éléments graphiques du projet (interface).

15.1 Gestion des tables		Comment ajouter, changer et effacer des tables
15.2 Gestion des champs		Ajouter, modifier et supprimer des champs
15.3 Gestion de l'affichage		Gérer les éléments graphiques du projet
15.4 Exporter une structure		Avoir un aperçu de toutes les tables et champs

15.1 Gestion des tables

Depuis le groupe `Tables' de l'éditeur de structure, vous pouvez créer, changer, supprimer et trier les tables.

15.1.1 Création de tables		Ajouter une table
15.1.2 Modification de tables		Modifier une table
15.1.3 Suppression de tables		Supprimer une table
15.1.4 Tri des tables		Ordonner la liste des tables

15.1.1 Création de tables

Pour créer une nouvelle table, appuyez sur le bouton `Nouveau' du groupe `Tables' ce qui ouvrira la fenêtre `Nouvelle table' contenant :

un champ de texte pour nommer la table. Chaque table doit avoir un nom unique commençant par une lettre majuscule suivie d'autres lettres, de chiffres ou de tirets bas. Les caractères non-ASCII (tréma, double point) ne sont pas autorisés. En revanche, il est tout à fait possible d'utiliser des caractères non-ASCII dans l'interface utilisateur de la table.
un champ `Nombre d'enregistrements' dans lequel vous définissez combien d'enregistrements comportera la table. `Illimité' signifie que la table peut contenir un nombre infini d'enregistrements, `Exactement un' signifie que la table ne peut comporter qu'un seul enregistrement. Ce champ est utile pour contrôler le projet (voir Tables).
un champ `Déclencheurs' dans lequel vous pouvez définir le nom de deux fonctions. Dans le champ `Nouveau' vous entrez le nom de la fonction à appeler à chaque fois que l'on veut créer un nouvel enregistrement, alors que le champ `Suppression' contient le nom de la fonction à appeler à chaque suppression d'enregistrement. Vous pouvez également utiliser les boutons déroulants situés à droite des champs de texte pour choisir à partir d'une liste de toutes les fonctions celle à appeler. Si vous laissez ces champs vides, alors ce sont les actions par défaut qui seront exécutées (les enregistrements sont créés automatiquement et les enregistrements sont effacés après une éventuelle requête de confirmation). Pour de plus amples informations concernant l'utilisation de ces déclencheurs, ainsi que le passage d'arguments, voir Déclencheur de création et Déclencheur de suppression.
une case à cocher `Compter les modifications'. Si active, chaque création ou suppression d'un enregistrement est compté comme un changement du projet. Dans le cas contraire aucun changement de la table (ou d'un de ses champs) n'est compté.
une case à cocher `Tracer les modifications'. Si active, chaque création ou suppression d'un enregistrement est enregistré dans le journal du projet. Dans le cas contraire aucun changement de la table (ou d'un de ses champs) n'est tracé.
deux boutons `Ok' et `Annuler' pour fermer la fenêtre.

Une fois que vous avez effectué tous les réglages, pressez le bouton `Ok' pour créer la nouvelle table. Si vous avez fait une erreur, comme entrer un nom invalide, un message s'affichera et vous donnera des informations sur l'erreur. À l'inverse si tout se passe correctement, la fenêtre `Nouvelle table' se fermera et la nouvelle table s'affichera dans la liste des tables de l'éditeur de structure.

15.1.2 Modification de tables

Après avoir créé une table, vous pouvez toujours la modifier. Il vous suffit de double cliquer sur le nom de la table et la fenêtre `Modifier la table' apparaîtra. Cette fenêtre est similaire à celle de création de table (voir Création de tables) et vous permet de modifier les champs en saisissant une nouvelle valeur.

Quand vous avez effectué toutes vos modifications appuyez sur le bouton `Ok' pour fermer la fenêtre.

Notez que vous ne pouvez pas changer le nombre d'enregistrements d'`Illimité' en `Exactement un' si la table contient déjà plus d'un enregistrement.

15.1.3 Suppression de tables

Pour supprimer une table, sélectionnez son nom dans la liste de l'éditeur de structure, puis cliquez sur le bouton `Supprimer' sous la liste. Avant de supprimer définitivement la table, une requête de confirmation sera ouverte. Si vous confirmez en appuyant sur le bouton `Supprimer', la table sera irrémédiablement supprimée.

Un problème se pose si la table est utilisée ailleurs dans un projet. Dans ce cas, la table ne peut pas être supprimée directement. Toutes les références à cette table doivent être éliminées du programme. Si la table à supprimer est utilisée dans un projet, l'éditeur apparaîtra et affichera la première référence de la table. Vous devez alors modifier le programme de manière à éliminer toute référence à la table. Après avoir éliminé une référence, vous pouvez aller à la prochaine en cliquant sur le bouton `Compiler'. Vous pouvez à tout moment annuler l'opération en cliquant sur le bouton `Rétablir' et fermer l'éditeur.

15.1.4 Tri des tables

Vous pouvez trier les tables dans le champ `Tables' de l'éditeur de structure de plusieurs façons. Vous pouvez les arranger manuellement par glisser/déposer ou vous pouvez utiliser le bouton `Tri' sous la liste pour les classer par ordre alphabétique (`Tri 1') ou bien encore en fonction de l'ordre de la liste d'affichage (`Tri 2').

15.2 Gestion des champs

Avec le champ `Champs' de l'éditeur de structure, vous pouvez créer, copier, modifier, effacer et trier les champs de la table sélectionnée dans `Tables'.

15.2.1 Création de champs		Comment ajouter un champ
15.2.2 Réglages liés au type de champ		Les réglages en fonction du type de champ
15.2.3 Éditeur d'entrée		Définir les différentes options pour un champ de type choix
15.2.4 Copie de champs		Copier un champ
15.2.5 Modification de champs		Comment modifier un champ
15.2.6 Suppression de champs		Comment supprimer un champ
15.2.7 Tri des champs		Comment trier la liste des champs

15.2.1 Création de champs

Pour créer un nouveau champ dans la table active, cliquez sur le bouton `Nouveau' dans le champ `Champs'. Cette action ouvrira la fenêtre `Nouveau champ' qui contient les éléments suivants :

un champ de texte pour entrer le nom du champ. Chaque champ d'une table doit avoir un nom unique commençant par une lettre majuscule suivie d'autres lettres, chiffres ou tiret bas. Les caractères non-ASCII (les trémas par exemple) ne sont pas autorisés. Cependant il est toujours possible d'utiliser pour les champs (dans l'interface utilisateur) n'importe quel caractère y compris non-ASCII.
une liste `Type' dans laquelle vous précisez le type de champ. Pour plus de précision sur les types de champ, voir Types de champ.
une section sous le champ `Type' pour préciser les réglages spécifiques au type de champ. Pour plus de précisions sur cette section, voir Réglages liés au type de champ.
un champ `Déclencheur' dans lequel vous donnez le nom d'une fonction qui sera appelée chaque fois que l'utilisateur voudra modifier le contenu du champ dans un enregistrement. Vous pouvez utiliser le bouton contextuel (ou bouton déroulant) à droite du champ de texte pour sélectionner un nom parmi une liste de noms de fonction. Si vous laissez ce champ vide, alors l'action par défaut sera exécutée, ce qui veut dire que la valeur entrée sera simplement stockée dans le champ. Pour plus de précision sur le déclenchement de fonction, y compris comment passer des arguments, voir Déclencheur de champ.
une case à cocher `Tenir compte des modifications'. Si elle est cochée, toute modification dans un champ d'un enregistrement, sera considérée comme une modification du projet. Décochez cette case si vous voulez ignorer les modifications de champ.
un champ `Tracer les modifications', qui, si coché, trace toute modification de champ d'un enregistrement . Notez que cet élément est actif à la condition que l'option `Tracer les modifications' d'un élément de table ait été également activé (voir Création de tables).
deux boutons `Ok' et `Annuler' pour fermer la fenêtre.

Lorsque vous avez effectué vos réglages, appuyez sur le bouton `Ok' pour créer le nouveau champ. Si vous avez fait une erreur tel qu'un nom invalide, un message s'affichera et vous donnera des informations sur l'erreur. À l'inverse si tout se passe correctement, la fenêtre `Nouveau champ' se fermera et le nouveau champ s'affichera dans la liste des champs de l'éditeur de structure.

15.2.2 Réglages liés au type de champ

Voici les modifications spécifiques aux types de champ que l'on peut effectuer :

Pour les champs de type Texte :
- un champ de type Entier `Taille maximum' pour définir la longueur maximale pour ce champ.
- un champ de type Texte `Valeur par défaut' pour définir la valeur par défaut de ce champ. On peut entrer n'importe quel texte dans la limite de la longueur maximale.
Pour les champs de type Entier, Réel, Date et Heure :
- un champ `Valeur par défaut' dans lequel vous définissez la valeur par défaut de ce champ. Vous avez le choix entre `NIL' et `Autre'. Si vous utilisez `Autre' vous devez spécifier une valeur initiale dans le champ de texte à droite.
- un champ de type Texte `chaîne NIL' dans lequel vous définissez le texte qui sera affiché lorsque le champ contiendra la valeur NIL.
Le réglage spécifique aux champs de type Booléen comprend un champ `Valeur par défaut' dans lequel vous entrez la valeur par défaut : soit `NIL' soit `TRUE'.
Pour les champs de type Choix :
- un bouton `Édition des entrées' pour ouvrir la fenêtre `Édition des entrées' et donnez un nom au champ de type Choix (voir Éditeur d'entrée).
- un champ `Valeur par défaut' dans lequel vous entrez la valeur par défaut.
Pour les champs de type Référence :
- une liste de toutes les tables pour sélectionner celle vers laquelle pointera le champ. En cliquant sur la table, le champ ira vers la référence.
- un champ `Affichage auto'. S'il est coché, la table de référence sera mise à jour automatiquement en fonction de l'enregistrement de référence, chaque fois que l'utilisateur passera à un autre enregistrement.
- un champ `Filtrer ?'. S'il est coché, le filtre de référence de ce champ sera activé. Voir Filtre de référence pour plus de précision.
Les champs de type Référence ont toujours NIL comme valeur par défaut.
Le réglage spécifique aux champs de type Virtuel concerne
- un champ de texte `Calculer' dans lequel vous donnez le nom de la fonction à lancer pour calculer la valeur du champ. Vous pouvez vous servir du bouton déroulant pour sélectionner un nom parmi une liste de tous les noms de fonction. Veuillez voir Programmation de champs virtuels pour en savoir plus sur l'utilisation de cette fonction.
- un champ de type Texte `chaîne NIL' dans lequel vous définissez le texte qui sera affiché lorsque le champ contiendra la valeur NIL.
Les champs de type Mémo et Bouton n'ont pas de réglages propres. La valeur par défaut des champs de type Mémo est une ligne de texte vierge.

15.2.3 Éditeur d'entrée

L'éditeur d'entrées intervient à chaque fois que vous devez définir une liste comme par exemple une liste de noms pour un champ de type Choix. L'éditeur se compose d'une fenêtre qui contient :

une liste montrant les entrées existantes. Cliquer sur une entrée la sélectionner. Elle sera visible dans le champ de texte sous la liste. Vous pouvez utiliser le glisser/déposer pour réarranger les entrées.
un champ de texte `Entrée' qui affiche l'entrée sélectionnée et permet également de la modifier. Les modifications ne seront prises en compte que lorsque vous appuyez sur la touche Entrée. S'il n'y a aucune entrée sélectionnée, la pression sur Entrée ajoutera une nouvelle entrée à la liste.
un bouton `Nouveau' qui désélectionne l'entrée courante, ce qui permet d'ajouter de nouvelles entrées dans le champ de texte `Entrée'.
un bouton `Supprimer' qui efface l'entrée sélectionnée de la liste.
un bouton `Trier' pour trier par ordre alphabétique la liste d'entrées.
deux boutons `Ok' et `Annuler' pour quitter l'éditeur d'entrées.

Après avoir ajouté toutes les entrées ou les avoir changées, pressez le bouton `Ok' pour fermer la fenêtre.

15.2.4 Copie de champs

Dans le cas où vous avez besoin de plusieurs champs similaires, il vous est possible de copier un champ. Pour cela, sélectionnez le champ à dupliquer et cliquez sur le bouton `Copier' sous la liste de champ. Cette action ouvre une requête `Copier le champ' montrant les options du champ sélectionné. Modifiez certaines parties comme le nom puis cliquez sur `Ok' pour générer une copie du champ.

15.2.5 Modification de champs

Après la création d'un nouveau champ, il est toujours possible de modifier ses réglages. Pour cela, double-cliquez sur le nom du champ ce qui laissera apparaître la requête `Modifier le champ'. Cette requête est semblable à celle de création d'un champ (voir Création de champs) et permet de modifier certains paramètres. Les paramètres ne pouvant être modifiés, comme le type de champ, apparaissent grisés.

Les choses à prendre en compte lors d'un changement de champ sont les suivantes :

Le type de champ ne peut être changé. Si vous devez changer le type d'un champ, il est préférable d'en créer un nouveau du type voulu et de copier les enregistrements du champ à remplacer vers le nouveau champ en entrant un programme BeeBase dans l'éditeur de requête (voir Éditeur de requêtes).
Si vous modifiez la valeur par défaut d'un champ, seuls les nouveaux enregistrements auront cette nouvelle valeur d'initialisation.
Certaines précautions sont à prendre pour le changement d'entrées des champs de type Choix. Les entrées sont uniquement utilisées pour visualiser le contenu du champ, mais en interne, ce sont des numéros qui sont stockés et utilisés comme index dans la liste d'entrées. Donc si vous modifiez l'ordre des entrées, vous ne modifiez pas le numéro en interne mais sa visualisation sous forme d'entrées ! Par conséquent, vous ne devriez pas changer l'ordre des entrées après avoir crée un champ de type Choix. Par contre l'ajout de nouvelles entrées à la fin de la liste ne pose pas ce genre de problème. Pour une plus grande flexibilité avec possibilité de changer l'ordre des entrées, utilisez plutôt un champ de type Texte associé à une `liste déroulant' (voir Éditeur de champ).
La table de référence d'un champ Référence ne peut pas être modifiée.

Si vous en avez terminé les modifications, pressez le bouton `Ok' pour fermer la requête.

15.2.6 Suppression de champs

Pour effacer un champ, cliquez sur son nom dans la liste des champs de l'éditeur de structure et appuyez sur le bouton `Supprimer' situé sous la liste. Une requête de confirmation apparaîtra et si vous confirmez en appuyant à nouveau sur `Supprimer', le champ sera définitivement effacé.

Un problème peut se poser lorsque le champ est utilisé ailleurs dans le projet. Dans ce cas, le champ ne peut être simplement effacé mais toutes les références à celui-ci doivent impérativement disparaître du programme. Si le champ à effacer est utilisé ailleurs, l'éditeur de programme apparaîtra et affichera la première occurrence de ce champ. Vous devrez alors modifier le programme de manière à ce qu'il ne contienne plus aucune référence à ce champ. Après chaque suppression d'une référence, vous passez à la suivante en appuyant sur le bouton `Compiler'. À tout moment vous pouvez annuler toute l'opération en appuyant sur `Rétablir' et en refermant l'éditeur de programmes.

15.2.7 Tri des champs

Le classement des champs dans la partie `Champs' de l'éditeur de structure peut se faire de plusieurs façons. Vous pouvez le faire à la main par glisser/déposer, ou utiliser le bouton `Tri' sous la liste qui permet un tri par ordre alphabétique (`Tri 1'), ou encore un tri suivant l'ordre de l'affichage de la liste (`Tri 2').

15.3 Gestion de l'affichage

Dans la partie `Affichage' de l'éditeur de structure, vous définissez l'agencement des éléments de la base de données dans l'interface utilisateur. Cette section comporte une partie choix, une partie liste et plusieurs boutons.

15.3.1 Champ d'affichage		Vue d'ensemble des éléments dans le champ d'affichage
15.3.2 Éditeur de table		Réglages pour un objet table
15.3.3 Éditeur de champ		Réglages pour un objet champ
15.3.4 Réglages liés au type		Réglages liés au type
15.3.5 Éditeur de texte		Réglages pour un objet texte
15.3.6 Éditeur d'image		Réglages pour un objet image
15.3.7 Éditeur d'espacement		Réglages pour un objet séparateur
15.3.8 Éditeur de groupe		Réglages pour un objet groupe
15.3.9 Éditeur de registre		Réglages pour un objet groupe enregistré
15.3.10 Éditeur de fenêtre		Réglages pour un groupe fenêtre

15.3.1 Champ d'affichage

Le champ d'affichage contient les éléments suivants :

un élément de sélection avec deux réglages, `Fiche de table' et `Fenêtre principale'. Dans `Fiche de table' vous définissez l'agencement des champs de la table active dans l'interface utilisateur. Dans `Fenêtre principale' vous définissez l'arrangement des tables.
une liste montrant la disposition actuelle de l'interface utilisateur. La liste se présente sous forme d'arborescence. Les éléments ayant une flèche à leur gauche sont des objets d'IHM composés pouvant être ouverts ou fermés en (double-) cliquant sur le symbole de la flèche. Un double clic sur l'élément lui-même ouvre une fenêtre permettant l'édition de ses réglages. Tous les objets d'IHM issus du même objet parent sont placés de manière identique (horizontalement ou verticalement). La représentation est déterminée par l'objet d'IIHM parent : les éléments des tableaux, onglets et fenêtres sont placés verticalement alors que les éléments des groupes sont placés en fonction des réglages définis par l'éditeur de groupe (voir Éditeur de groupe).
un bouton `+' (`Ajouter') pour ajouter la table sélectionnée ou le champ sélectionné (suivant ce qui est affiché dans la partie choix) à la liste. En général, les tables et les champs sont ajoutés à la liste automatiquement après leur création.
un bouton `-' (`Supprimer') pour retirer de la liste ce qui est sélectionné. Si vous retirez une table, la totalité du formulaire de la table sera enlevé de l'interface utilisateur. De ce fait, vous ne pourrez plus voir la table dans l'interface projet et pourrez cacher des tables entières. Idem pour les champs : retirez un champ équivaut à le cacher de l'interface projet.
deux boutons `Haut' et `Bas' pour déplacer l'élément sélectionné vers le haut ou vers le bas dans la liste.
deux boutons `Entrée' et `Sortie' pour déplacer l'élément sélectionné vers un niveau hiérarchique plus élevé ou plus bas dans la liste.
un bouton `Texte' pour ajouter un objet texte dans la liste (voir Éditeur de texte).
un bouton `Image' pour ajouter un objet image (voir Éditeur d'image).
un bouton `Séparateur' pour insérer un espace entre les autres objets (voir Éditeur d'espacement).
un bouton `Balance' pour ajouter un objet balance dans la liste. Cet objet est très utile pour contrôler la taille des autres objets graphiques.
un bouton `Groupe' pour ajouter un objet groupe dans la liste. Avant d'appuyer sur ce bouton, vous pouvez sélectionner plusieurs éléments dans la liste pour les déplacer dans un nouveau groupe (voir Éditeur de groupe).
un bouton `Registre' pour ajouter un groupe enregistré dans la liste. Comme pour l'objet groupe, il est possible de sélectionner plusieurs objets graphiques afin de les déplacer vers le nouveau groupe enregistré (voir Éditeur de registre).
un bouton `Fenêtre' pour ajouter une nouvelle fenêtre dans la liste. Comme précédemment, il est possible de sélectionner plusieurs objets graphiques pour les déplacer dans la nouvelle fenêtre (voir Éditeur de fenêtre).

Pour plus de précisions concernant les éléments graphiques ainsi que la façon de les utiliser, voir Interface graphique.

15.3.2 Éditeur de table

Lors de l'ajout d'une table, un objet d'affichage par défaut est créé. Pour modifier ses paramètres, double-cliquer la table dans la liste `Affichage' et la fenêtre `Affichage de la table' apparaîtra. La fenêtre a trois sections séparées en onglet : `Général', `Onglet' et `Enregistrement'.

La section `Général' contient les éléments suivants :

un champ numérique `Poids' pour spécifier le poids d'un objet. La valeur de ce champ détermine la proportion de place occupée, relativement aux autres champs par la table lors du rendu final de la fenêtre.
un champ `Arrière-plan' avec une case à cocher `Défaut' pour définir l'apparence de l'arrière-plan de la table. Si le champ `Défaut' est coché, alors l'arrière-plan par défaut sera affiché, autrement vous pouvez cliquer sur le champ `Arrière-plan' pour ouvrir une fenêtre de configuration de l'arrière-plan.
une case à cocher `A un onglet' qui indique si un onglet doit être affiché en haut de la table. Décocher ce champ pour masquer l'onglet. Pour des précisions sur les onglets, voir Onglets.

La section `Onglet' est activée seulement si le champ `A un onglet' est coché. Il contient les éléments suivants :

un champ de texte `Titre' pour donner un titre à l'entête de l'onglet.
un champ de texte `Police de caractères' avec un bouton déroulant pour choisir la police du titre. Si vous laissez le champ vide, la police par défaut sera utilisée.
un champ `Arrière-plan' avec une case à cocher `Défaut' pour définir l'image de fond de l'entête du panel. Si le champ `Défaut' est coché, alors l'image de fond par défaut sera utilisée. Sinon vous pouvez cliquer sur `Arrière-plan' pour ouvrir une requête et en sélectionner une.
un champ `Num / Tous'. S'il est coché, le numéro de l'enregistrement en cours et le nombre total d'enregistrements apparaîtront dans la partie droite de l'entête du panel.
un champ `Filtre' qui, si coché, ajoute un bouton de filtrage à l'entête du panel et permet d'activer ou non le filtrage d'enregistrement de la table. S'il n'est pas coché, l'élément du menu `Table - Modification du filtre' sera aussi désactivé pour cette table et vous ne pourrez plus ajouter de filtre pour la table. Pour plus d'informations sur le filtrage des enregistrements, voir Filtre d'enregistrement.
un champ `Flèches' pour ajouter deux boutons flèches au masque de la table. Ces flèches permettent la navigation entre les enregistrements de la table. S'il n'est pas coché, vous ne pourrez pas naviguer dans les enregistrements et tous les sous-menus du menu `Atteindre l'enregistrement' ainsi que les éléments `Rechercher', `Rechercher en avant', et `Rechercher en arrière' du menu `Table' seront désactivés.

La section `Enregistrement' permet de spécifier une description d'enregistrement. La description d'enregistrement est utilisée à la création des entrées de journal et dans les listes déroulantes pour la sélection des enregistrements. Ce doit être un identifiant court mais unique. La section contient les éléments suivants :

un champ Choix `Description' à définir sur `Champs' ou `Calculé'.
Si `Description' est défini à `Champs' alors une liste de champs de la table est affichée. Vous pouvez choisir n'importe quel élément pour la description d'enregistrement. Si vous sélectionnez `Numéro d'enregistrement' alors le numéro d'un enregistrement sera ajouté à son affichage. Plusieurs éléments peuvent être sélectionnés et vous pouvez réarranger l'ordre des éléments par glisser-déplacer.
Si `Description' est défini à `Calculé' alors le champ `Calculer' sera affiché pour indiquer une fonction qui calcule la description de l'enregistrement. La fonction peut soit retourner une expression ou une liste d'expressions (voir Calculer la description de l'enregistrement).
une case à cocher `Utiliser des listes multi-colonnes' pour indiquer l'arrangement préféré quand l'affichage est en liste .

Sous les sections séparées par des tabulations, il y a deux boutons `Ok' et `Annuler' pour fermer la fenêtre. Si vous en avez terminé avec les modifications, pressez le bouton `Ok' pour fermer la fenêtre.

15.3.3 Éditeur de champ

Lorsque vous ajoutez un champ à la liste, un objet graphique par défaut lui sera attribué. Pour modifier les réglages de cet objet, un double clic ouvre la fenêtre `Affichage du champ'. Le contenu de cette fenêtre dépend du type de champ. Les éléments suivants sont disponibles pour la plupart des types de champ :

un champ texte `Titre' pour le titre qui sera affiché à côté de l'objet champ (ou à l'intérieur de l'objet si c'est un bouton). Si vous laissez cette partie vide, aucun titre ne sera affiché.
une partie choix `Position' pour définir la position du titre (s'il y en a un) par rapport un champ objet. Vous avez le choix entre `Gauche', `Droite', `Haut' et `Bas'.
un champ texte `Raccourci' pour la saisie d'une lettre qui sera utilisée conjointement avec la touche Alt (pour Linux et Windows) ou la touche Amiga (pour AmigaOS) pour activer l'objet.
un champ `Accueil'. Si coché, l'objet Champ correspondant sera l'objet de démarrage du cycle de focus d'un nouvel enregistrement. C'est très pratique dans le cas où vous entrez vos données en commençant toujours par le même champ. Lorsque vous définissez un champ en tant qu'objet "home", tous les autres objets Champ de cette table perdront cette propriété.
un champ `Navigation cyclique'. Si coché, l'objet fera partie de la chaîne de focus qui utilise la touche Tab pour faire défiler les objets. Ne cochez pas cette case si vous ne voulez pas inclure cet élément.
un champ `Lecture seule' qui, si coché, passe le champ en lecture seule. Cela signifie que vous pouvez lire le contenu mais pas le modifier. À noter cependant que si vous ajoutez un bouton popup à l'objet, le contenu pourra être modifié par la sélection du popup.
un champ choix `Alignement' pour fixer la représentation du contenu d'un objet. Vous avez le choix entre `Centre', `Gauche' et `Droite' pour respectivement afficher au centre, à gauche ou à droite.
un champ numérique `Poids' pour définir le poids de l'objet. Cette valeur définie la place occupée par cet objet dans la représentation finale par rapport aux autres objets. Pour la plupart des types de champs, cela n'affectera que la taille horizontale parce que la plupart des objets ont une taille prédéfinie. Pour un champ de type Mémo, cela affectera également la taille verticale.
un champ `Police de caractères' pour choisir la police utilisée pour l'affichage du contenu du champ. La police par défaut sera utilisée si vous laissez ce champ vide.
un champ `Arrière-plan' avec une case à cocher `Défaut' pour définir la représentation du fond du champ. Si la case `Défaut' est cochée, un arrière-plan par défaut sera utilisé. Sinon vous cliquez sur `Arrière-plan' pour ouvrir une fenêtre de sélection pour l'arrière-plan.
un champ édition `Infobulle' pour définir le texte qui sera affiché dans la bulle d'aide pour l'objet Champ.
une zone `Activé/désactivé'. Si `Toujours activé' est sélectionné alors l'objet est toujours activé indépendamment de l'enregistrement affiché. `Désactivé sur initial' désactive l'objet pour l'enregistrement initial mais l'active dans tous les autres cas. Si `Calculer activation' est choisi alors une fonction pour calculer l'état d'activation de l'objet peut être spécifiée sur la droite. La fonction ne requiert aucun argument. Si elle renvoie NIL alors l'objet est désactivé, sinon il est activé. Dans le cas où le déclencheur est laissé vide ou ne peut pas être trouvé, l'objet est désactivé. Pour plus d'informations sur la façon d'utiliser ce déclencheur, voir Fonction de calcul d'activation.
deux boutons `Ok' et `Annuler' pour fermer et quitter la fenêtre.

Une fois les réglages effectués, appuyez sur le bouton `Ok' pour fermer la fenêtre.

15.3.4 Réglages liés au type

Parmi les éléments ci-dessus, ceux qui suivent sont spécifiques au type de champ :

Pour les champs de type texte, il existe une page `Extras' qui contient :
- un champ `Afficher l'image' qui, si coché, joint un champ image au champ texte pour afficher une image dont le nom provient du contenu du champ. Le champ image est placé au-dessus du champ texte. Si vous ne cochez pas ce champ, les réglages des éléments `Titre du champ texte', `Masquer le champ texte' et `Taille' sont superflus.
- un champ `Titre du champ texte'. Si elle est cochée, le titre de l'objet Champ est placé à gauche de la partie texte pour ménager un espace plus important pour la partie image. Sinon, le titre sera placé à côté de la partie image.
- un champ `Masquer le champ texte' pour dissimuler la partie texte dans l'interface utilisateur. Si elle est cochée, seule la partie image sera visible.
- un champ `Taille' pour définir le redimensionnement du champ image. Si `Redimensionnable' est sélectionné, l'objet peut être redimensionné et pourrait devenir plus grand que la taille de l'image. `Fixé' adapte la taille de l'objet à la taille de l'image. Si la taille de l'image change en fonction des enregistrements, alors l'objet est également redimensionné à chaque fois. `Défilable' ajoute deux barres de déplacement à l'objet pour voir les images qui seraient plus grandes que la zone visible. Si `Ajusté' est sélectionné, la taille de l'image est redimensionnée de façon à s'adapter à la taille de l'objet affiché. `Homothétique' permet également le redimensionnement mais en préservant les proportions originales.
- un champ `Sélecteur de fichier' qui, si coché, ajoute un bouton déroulant à droite du champ texte. Ce bouton permet d'afficher une requête pour sélectionner un nom de fichier.
- un champ `Sélecteur de polices de caractères' pour ajouter une liste de sélection d'une police de caractères.
- un champ `Sélecteur de liste'. Si coché, un bouton déroulant sera ajouté à la droite du champ texte permettant de choisir le texte parmi une liste. Le texte des entrées pour la liste déroulante est défini à droite du champ. Les éléments peuvent être soit `Statiques', soit `Calculés'. Si `Statiques' est choisi alors la liste de chaînes peut être saisie dans l'éditeur d'entrées qui s'ouvre après un clic sur le bouton `Modifier les entrées'. Pour plus de renseignements sur l'éditeur d'entrées, consultez voir Éditeur d'entrée. Si `Calculé' est sélectionné alors un déclencheur peut être désigné dans le champ `Compute', il sera exécuté à chaque fois que le bouton déroulant sera cliqué. Cette fonction doit retourner un mémo contenant une entrée par ligne ou NIL pour une liste vide (voir Calculer les entrées des listes). Seulement un des champs `Sélecteur de fichier', `Sélecteur de polices de caractères' et `Sélecteur de liste' peut être sélectionné à la fois.
- un champ `Vue' qui, si coché, rajoute un bouton à droite du champ texte permettant de lancer un programme de visualisation externe avec le contenu du champ comme argument. C'est très pratique dans le cas où vous stockez les noms de fichiers dans le champ et voudriez voir le contenu d'un fichier via un programme de visualisation externe. Ce programme de visualisation est défini dans le menu `Préférences - Visionneuse externe' (voir Visionneuse externe).
pour les champs de type Choix, il existe une partie `Type' qui vous permet de choisir si le contenu du champ sera affiché par un `Bouton cyclique' ou bien par un groupe de `Boutons radio'. Si vous choisissez `Bouton cyclique' alors vous pouvez définir la position du titre parmi `Gauche', `Droite', `Haut', ou `Bouton'. Si vous choisissez `Boutons radio' alors les deux éléments `Cadre' et `Horizontal' permettent d'avoir une bordure autour des boutons et de définir l'aspect horizontal.
pour les champs de type Réél il existe un champ Entier `Num décimal' dans lequel vous définissez le nombre de chiffres après la virgule qui seront affichés.
pour les champs de type date, il y a un champ case à coche `Calendrier' qui ajoute un bouton pop-up à droite du champ de date pour ouvrir un calendrier.
pour les champs de type Date il existe un champ choix `Format' pour définir l'aspect visuel. Vous avez le choix entre `HH:MM:SS', `MM:SS' et `HH:MM'. Si vous choisissez `HH:MM', les secondes ne seront pas affichées et les valeurs d'entrées seront considérées comme des minutes.
pour les champs de type Référence il existe une page `Extras' qui comportent les éléments suivants :
- une section `Affichage' où saisir la description d'un enregistrement qui spécifie le contenu d'un enregistrement référencé à afficher. Voir Éditeur de table, pour des précisions sur la configuration d'une description d'enregistrement. Notez que le champ de choix `Description' a une entrée `Depuis la table'. Si sélectionnée, la configuration de l'objet table est utilisée pour afficher l'enregistrement référencé.
- une zone `Déroulante' dans laquelle vous pouvez spécifier quels enregistrements de la table référencée doivent être disponibles dans la liste déroulante du champ Référence et comment ils doivent être affichés. Si `Enregistrements' est positionné sur `Tous' alors tous les enregistrements sont disponibles. Si `Enregistrements' est positionné sur `Correspondant au filtre' alors seuls les enregistrements de la table référencée correspondant au filtre installé sont disponibles. Si `Enregistrements' est positionné sur `Calculé' alors une fonction pour calculer l'ensemble d'enregistrements peut être saisie dans le champ `Calculer'. Cette fonction déclencheur doit retourner une liste qui est parcourue à la recherche d'enregistrements de la table référencée. Ces enregistrements identifiés sont affichés dans la liste déroulante. Les éléments qui ne sont pas des enregistrements sont ignorés. Voir Calculer les enregistrements référencés, pour plus d'informations sur cette fonction. En plus de ces enregistrements spécifiés par le réglage `Enregistrements', l'enregistrement initial et l'enregistrement courant de la table référencée peuvent être ajoutés à la liste déroulante en cochant respectivement les options `Enregistrement initial' et `Enregistrement courant'.
- un champ `Affichage'. Si coché, la création de l'objet graphique représentant la référence sera un bouton. En cliquant sur celui-ci, vous verrez l'enregistrement référencé dans le masque de la table de référence. Pour cela, la fenêtre contenant la table de référence s'ouvrira au premier plan si nécessaire.
- un champ `Affichage automatique' qui, si coché, ajoute un bouton à droite du champ référence pour une visualisation automatique ou non du champ. En l'activant, la table de référence sera mise à jour automatiquement avec l'enregistrement référencé à chaque fois que l'utilisateur passera à un autre enregistrement.
- un champ `Filtre' qui, si coché, ajoute un bouton à droite du champ référence pour appliquer ou non un filtre de référence sur le champ. Voir Filtre de référence, pour plus d'informations sur les filtres de référence.
pour les champs de type Virtuel, l'éditeur d'objet Champ contient une page `Extras' avec les options suivantes :
- une liste de choix `Type' dans laquelle vous définissez comment le contenu du champ devra être affiché. Vous pouvez opter pour `Booléen' qui utilise une zone à cocher pour afficher les valeurs booléennes, ou pour `Texte' qui utilise une zone de texte pour afficher une ligne de texte (y compris la date, l'heure et les valeurs numériques), ou encore `Liste' qui utilise une liste pour afficher une liste de lignes (exemple : le résultat d'une requête select-from-where).
- en réglant l'élément `Type' sur `Texte', deux nouveaux champs seront disponibles : `Alignement' pour définir comment sera présenté le contenu du champ, et `Nombres décimaux' pour fixer le nombre de chiffres affichés après la virgule pour le contenu un champ de type Réel.
- Si le champ `Type' a été défini sur `Liste' alors davantage de champs sont disponibles : `Afficher les titres', `Navigation cyclique', `Sur double clic', `Déclencheur sur glisser-déposer d'URL', et `Déclencheur de tri-déplacement'. Si `Afficher les titres' est coché, la premier ligne du contenu du champ est affiché en titre de la liste. Autrement aucun titre n'est affiché et la première ligne est ignorée. Si `Navigation cyclique' est coché, l'objet fait partie du cycle de focus atteignable par la touche Tab. Décocher cela si vous voulez sauter cet élément. Dans `Sur double clic' vous pouvez indiquer l'action de cet événement sur une entrée de la liste. `Ne rien faire' ignore le double clic. `Afficher l'enregistrement' affiche l'enregistrement correspondant à l'élément cliqué. Si vous sélectionnez `Exécuter le déclencheur' vous pourrez préciser à droite le nom d'une fonction déclencheur appelée à chaque double clic. Pour plus d'informations sur les déclencheurs et leurs arguments, voir Déclencheur de double-clic. Dans `Déclencheur sur glisser-déposer d'URL', vous pouvez entrer le nom d'une fonction de déclenchement qui est appelée lorsque l'utilisateur fait un glisser-déposer d'une liste d'URL (p. ex. des noms de fichiers) sur la vue de liste. Cela peut être utilisé, par exemple, pour stocker des noms de fichiers externes dans un projet. Voir Déclencheur sur glisser-déposer d'URL pour plus d'informations sur cette fonction de déclencheur, y compris les arguments qui lui sont transmis. Dans `Déclencheur de tri-déplacement', vous pouvez entrer le nom d'un déclencheur qui est appelé lorsque l'utilisateur fait un glisser-déposer d'un élément pour trier les éléments dans la vue liste. Cela peut être utilisé, par exemple, pour changer l'ordre des enregistrements dans une table ou pour réorganiser les lignes dans un champ mémo. Voir Déclencheur de tri-déplacement pour plus d'informations sur ce déclencheur, y compris les arguments qui lui sont transmis.
- un champ `Mise à jour automatique'. Si coché, le champ Virtuel est recalculé automatiquement à chaque changement d'un élément dépendant. Cela inclut le changement d'enregistrement dans une table dépendante, la modification d'un champ dépendant, l'ajout ou la suppression d'un enregistrement dans une table dépendante, basculer le mode utilisateur / administrateur du projet ou recompiler le programme du projet. Les dépendances d'un champ Virtuel sont obtenues automatiquement depuis la fonction de calcul du champ Virtuel. Utilisez le menu `Projet - Exporter la structure' pour visualiser toutes les dépendances obtenues (il peut être nécessaire de recompiler le programme du projet afin de mettre à jour les dépendances lors de l'activation de cette fonction). Veuillez noter que le champ Virtuel est recalculé quel que soit l'enregistrement dans lequel un champ dépendant est modifié et sans tenir compte si la valeur du champ dépendant est modifiée depuis l'interface utilisateur ou au cours de l'exécution du programme. Toutefois, la mise à jour automatique des champs virtuels se déroule généralement seulement après que toutes les autres exécutions du programme sont terminées. Si `Mise à jour automatique' est décoché, la valeur du champ Virtuel n'est calculée que lorsque cela est explicitement demandé ou qu'elle est modifiée dans une fonction du programme.
Voici les options supplémentaires pour les boutons :
- un champ choix `Type' dans lequel vous choisissez entre `Bouton texte' et `Bouton image'.
- si vous choisissez le type `Bouton texte' les options suivantes seront disponibles : `Titre', `Police de caractères', `Arrière-plan' et `Défaut' pour respectivement donner un titre au bouton, choisir sa police d'affichage et les réglages d'arrière-plan.
- si vous choisissez le type `Bouton image' les options suivantes seront disponibles : `Image' pour choisir l'image et `Taille' pour définir sa taille.

15.3.5 Éditeur de texte

Lorsque vous ajoutez un objet de texte dans la liste d'affichage ou lorsque vous en modifiez un par double clic, la fenêtre `Texte' apparaîtra et proposera les options suivantes :

un champ texte `Titre' pour définir le texte à afficher.
un champ numérique `Poids' pour définir la largeur de l'objet de texte.
un champ choix `Police de caractères' pour définir la police du texte. Si vous laissez le champ vide, la police par défaut sera utilisée.
un champ `Arrière-plan' et un champ `Défaut' pour définir les réglages de l'arrière-plan de l'objet de texte.
deux boutons `Ok' et `Annuler' pour fermer la fenêtre.