Nom commande

version 6.0

Nom commande (commande) Alpha

La fonction Nom commande retourne le nom (universel) de la commande dont le numéro a été passé dans commande.

4e Dimension comporte un système unique en son genre de traduction dynamique des mots-clés, constantes et noms de commandes que vous utilisez dans vos méthodes. Si, par exemple, vous écrivez dans la version anglaise de 4D :

   DEFAULT TABLE ([MyTable])
   ALL RECORDS ([MyTable])

Le même code, si vous l'ouvrez avec la version française de 4D, sera automatiquement traduit :

   TABLE PAR DEFAUT ([MyTable])
   TOUT SELECTIONNER ([MyTable])

Cependant, 4e Dimension comporte aussi une autre fonctionnalité unique, la commande EXECUTER, qui vous permet de construire à la volée et d'exécuter des parties de code même lorsque la base de données est compilée.

Si nous réécrivons le code précédent avec des commandes EXECUTE, en anglais, il prendra l'apparence suivante :

   EXECUTE ( "DEFAULT TABLE([MyTable])")
   EXECUTE ( "ALL RECORDS([MyTable])")

Le même code, ouvert avec la version française de 4D, sera automatiquement traduit :

   EXECUTER ( "DEFAULT TABLE([MyTable])")
   EXECUTER ( "ALL RECORDS([MyTable])")

4D traduit automatiquement la commande EXECUTE (anglais) en EXECUTER (français) mais ne peut pas traduire les instructions passées à la commande.

Si vous utilisez la commande EXECUTER dans votre application et si vous souhaitez éliminer les problèmes de traduction liés à ce type d'instructions, utilisez Nom commande pour rendre vos instructions indépendantes des localisations. L'exemple précédent devient alors :

   EXECUTE (Command name (46)+"([MyTable])")
   EXECUTE (Command name (47)+"([MyTable])")

La version française se lira :

   EXECUTER (Nom commande (46)+"([MyTable])")
   EXECUTER (Nom commande (47)+"([MyTable])")

Note : Pour connaître le numéro de chaque commande, reportez-vous à la section Syntaxe des commandes (liste alphabétique).

(1) Pour toutes les tables de votre base de données, vous avez créé un formulaire appelé "FORMULAIRE ENTREE" que vous utilisez pour la saisie dans chaque table. Vous voulez ajouter une méthode projet générique qui va désigner ce formulaire comme étant le formulaire entrée pour la table dont vous passez le nom ou le pointeur. Vous pouvez écrire :

      ` méthode projet FORMULAIRE ENTREE STANDARD 
      ` FORMULAIRE ENTREE STANDARD ( Pointeur {; Chaîne })
      ` FORMULAIRE ENTREE STANDARD ( ->Table {; NomTable })
   C_POINTEUR ($1)
   C_ALPHA (31;$2)

   Si (Nombre de parametres>=2)
      EXECUTER (Nom commande (55)+"(["+$2+"];"FORMULAIRE ENTREE")")
   Sinon
      Si (Nombre de parametres>=1)
         FORMULAIRE ENTREE ($1->;"FORMULAIRE ENTREE")
      Fin de si
   Fin de si

Une fois que cette méthode a été ajoutée dans votre base, vous pouvez écrire :

   FORMULAIRE ENTREE STANDARD  (->[Employés])
   FORMULAIRE ENTREE STANDARD  ("Employés")

Note : Généralement, il est préférable d'utiliser des pointeurs pour écrire des routines génériques. Tout d'abord, le code sera exécuté compilé si la base est compilée. Deuxièmement, 4D Insider récupérera les références des objets vers lesquels vous passez les pointeurs. Troisièmement, dans l'exemple ci-dessus, votre code cessera de fonctionner si vous renommez la table. Cependant, dans certains cas, l'utilisation de la commande EXECUTER peut être la réponse à vos besoins.

(2) Dans un formulaire, vous voulez afficher une liste déroulante contenant les commandes standard de génération d'états. Dans la méthode objet de cette liste déroulante, vous écrivez :

   Au cas ou
      : (Evenement formulaire =Sur Chargement)
         TABLEAU TEXTE (asCommand;4)
         asCommand{1}:=Nom commande (1) ` Somme
         asCommand{2}:=Nom commande (2) ` Moyenne
         asCommand{3}:=Nom commande (3) ` Min
         asCommand{4}:=Nom commande (4) ` Max
      ` ...
   Fin de cas

Dans une version anglaise de 4D, la liste déroulante contiendra : Sum, Average, Min et Max.

Dans une version française de 4D, la liste déroulante contiendra : Somme, Moyenne, Min et Max.

EXECUTER, Syntaxe des commandes (liste alphabétique).