Formulaire de sortie modifiable par l'utilisateur

Le premier champ de la table [Personnes] est un identifiant, défini comme invisible, qui n'est ni montré ni autorisé dans le formulaire de sortie. Consultez le trigger pour voir en détail comment on procède. Tous les autres champs sont disponibles pour figurer dans le formulaire de sortie.

Il y a deux formulaires pour la table [Personnes], « Input » et « Output ». Le formulaire « Input » est un formulaire standard d'entrée de données, sans programmation particulière.

Le formulaire « Output » contient six ensembles de quatre variables groupées par numéro, les noms de colonnes sont sColumnName1 à 6, les valeurs de colonnes sont sColumnValue1 à 6, les pop-ups de colonnes sont asColumnPopup1 à 6 et les séparateurs sont oColumnSplitter1 à 6. Toutes ces variables sont déplacées et dimensionnées par programmation lorsque le formulaire est appelé par l'utilisateur ; nous allons y venir. Le point important à noter sur le placement des variables est qu'elles sont déplacées et redimensionnées horizontalement, mais pas verticalement. Assurez-vous qu'elles soient bien alignées verticalement.

Notons au passage une propriété commode de 4D 2004 qui est de pouvoir placer les objets d'un formulaire dans différentes vues du formulaire. Dans cet exemple, il y a quatre niveaux de vues :

· le niveau 1 contient les boîtes de couleurs et les lignes ;
· le niveau 2 contient le texte d'information ;
· le niveau 3 contient les variables utilisées pour l'affichage et l'utilisation des champs ;
· et le niveau 4 contient les boutons d'ajout et de suppression.

Avoir les différents types d'objets situés dans différentes vues du même formulaire vous permet de sélectionner des objets en relation sans sélectionner en même temps un objet d'une autre catégorie. Ce n'est pas nécessaire pour cette note technique, mais je trouve que c'est une fonction très pratique de 4D 2004.

Le formulaire de sortie a sa méthode formulaire. Dans cette méthode formulaire, nous appelons la méthode projet Output_Columns lors des événements formulaire appropriés pour pouvoir mettre en place les colonnes stockées, utilisées ou modifiées selon les besoins. La méthode Output_Columns est décrite plus en détail quelques paragraphes plus bas.

Il y a plusieurs emplacements où se trouvent les méthodes et formulaires utilisés dans cette note technique.

· La méthode base Sur ouverture s'exécute lors de l'ouverture de la base et appelle, notamment, les deux méthodes projet qui concernent cet exemple.

· L'instruction Output_Columns (« Startup ») appelle la méthode projet Output_Columns décrite ci-dessous.

· People démarre un nouveau process qui ouvre le formulaire [Personnes]Output et exécute la commande MODIFIER SELECTION.

· Le trigger de la table [Personnes] est exécuté sur l'événement moteur Sur sauvegarde nouvel enregistrement. Cet événement se produit à chaque création d'enregistrement, que ce soit par la saisie d'un utilisateur, par import ou par programmation. Le champ ID est déclaré indexé, unique, invisible et non modifiable en structure.


LA METHODE PROJET Output_columns

Cette méthode contient tout le code nécessaire pour cette base exemple. Il pourrait être exécuté dans plusieurs méthodes distinctes, mais je trouve que l'on a tout dans un Au cas où. C'est plus facile à comprendre et à transférer dans une autre structure. Regardez le code lui-même pour des commentaires plus spécifiques à chaque section.

:($command= "Startup")

Cette section du code est appelée dans la méthode base Sur ouverture. En général, elle est exécutée une fois au démarrage et crée les variables interprocess utilisées par le reste du code. Vous pouvez ajouter d'autres formats d'affichage pour les nombres et les booléens si besoin. Les tableaux pour les dates et les heures sont ceux utilisés par 4D et ne doivent pas être modifiés.

:($command= "DefaultColumns")

Cette section est celle où vous fixez toutes vos colonnes par défaut et définissez toutes les variables utilisées dans cette note technique. Si vous voulez spécifier plus ou moins de colonnes ou une autre table, c'est la seule section de code à modifier. Toutes les autres sections de cette méthode l'utilisent et n'ont pas à être changées. Le seul autre endroit à mettre à jour est le formulaire de sortie lui-même, dans lequel vous devez ajouter ou supprimer les quatre variables utilisées pour chaque colonne.

:($command= "OnLoadForm")

Ce code est exécuté lorsque le formulaire est chargé pour la première fois. Il construit les variables popup et détermine l'emplacement de toutes les variables de colonnes selon ce qui a été précédemment sauvegardé, soit les valeurs par défaut, soit les dernières valeurs stockées.

:($command= "OnUnloadForm")

Lorsque vous fermez la fenêtre du formulaire de sortie, cette section du code est exécutée et elle enregistre les réglages de l'utilisateur final pour les colonnes, les champs, les emplacements, tailles, formatages, etc. La note technique suivante montrera comment ces réglages sont stockés dans une table de préférences du fichier de données et réutilisés au chargement de la base.

:($command="OnDisplayRow")

Cette section du code est exécutée une fois par ligne pour affecter à chaque colonne la valeur et le format souhaité selon le champ affiché. Ne rendez pas cette partie du code trop lente à exécuter, ou vos utilisateurs constateront un ralentissement à chaque ouverture de la fenêtre. 4D a l'avantage de ne recalculer le code que pour les lignes ajoutées lorsqu'on défile la liste, mais pas pour tout. Lorsqu'on ferme le formulaire d'entrée, toutes les lignes sont recalculées.

:($command= "HeaderClicked")

Il y a quatre sections dans ce code qui exécutent les actions suivantes lorsque vous cliquez sur un en-tête de colonne avec ces touches maintenues :

· Contrôle clic : choisissez un format pour un champ date, heure, numérique ou booléen ;
· Option clic : choisissez l'alignement (à gauche, centré, à droite) pour la colonne ;
· Majuscule clic : entrez le texte d'en-tête de colonne ;
· Clic : tri croissant sur la colonne cliquée ;
· Double clic ou clic droit : tri décroissant sur la colonne cliquée.

:($command= "PopupSelected")

Lorsque l'utilisateur sélectionne un nouveau champ dans le popup d'une colonne, la donnée est modifiée pour afficher ce nouveau champ. Le nom de la colonne, le format et l'alignement qui avaient été affectés sont remplacés par leur valeur par défaut.