4D v14.3

METHODE LIRE CHEMINS FORM

Accueil

 
4D v14.3
METHODE LIRE CHEMINS FORM

METHODE LIRE CHEMINS FORM 


 

METHODE LIRE CHEMINS FORM ( {laTable ;} tabChemins {; filtre}{; marqueur}{; *} ) 
Paramètre Type   Description
laTable  Table in Référence de table
tabChemins  Tableau texte in Tableau des chemins et noms des méthodes
filtre  Texte in Filtrage des noms
marqueur  Variable entier long in Valeur minimum de marqueur
in Nouvelle valeur courante
Opérateur in Si passé = la commande s’applique à la base hôte lorsqu’elle est exécutée depuis un composant (paramètre ignoré hors de ce contexte)

La commande METHODE LIRE CHEMINS FORM remplit le tableau tabChemins avec les chemins d’accès internes et les noms des méthodes de tous les objets des formulaires, ainsi que des méthodes formulaire. Les méthodes formulaire sont libellées {formMethod}. 

Seuls les objets contenant du code sont listés. Par exemple, les boutons uniquement associés à une action automatique ne sont pas retournés. 

Si vous passez le paramètre laTable, la commande retourne les objets des formulaires table associés à cette table. Si vous omettez ce paramètre, le commande retourne les objets des formulaires projet de la base. 

Vous pouvez restreindre la liste des formulaires en passant une chaîne de comparaison dans le paramètre filtre : dans ce cas, seuls les formulaires dont le nom correspond au filtre seront retournés. Vous pouvez utiliser le caractère @ afin de définir des filtres de type "commence par", "se termine par" ou "contient". Si vous passez une chaîne vide, le paramètre filtre est ignoré. 

Le paramètre marqueur vous permet de ne récupérer que les chemins des méthodes modifiées à compter d’un instant spécifique. Dans le cadre d’un système de contrôle de version, ce principe permet de mettre à jour uniquement les méthodes modifiées depuis la denière sauvegarde.
Le fonctionnement est le suivant : 4D maintient un compteur de modification des méthodes. A chaque fois qu’une méthode est créée ou réenregistrée, ce compteur est incrémenté et sa valeur courante est stockée dans le marqueur interne de la méthode. Si vous passez marqueur, la commande ne retourne que les méthodes dont le marqueur est supérieur ou égal à la valeur passée dans ce paramètre. De plus, la commande retourne dans marqueur la nouvelle valeur courante du compteur de modification, c’est-à-dire la valeur la plus élevée. Si vous stockez cette valeur, il vous suffira de la passer lors de l’appel suivant à la commande afin de ne récupérer que les méthodes nouvelles ou modifiées.

Si la commande est exécutée depuis un composant, elle retourne par défaut les chemins des méthodes du composant. Si vous passez le paramètre *, le tableau contiendra les chemins des méthodes de la base hôte. 

Note : La commande ne liste pas les objets des formulaires hérités ni des sous-formulaires.

Si la commande détecte un nom d'objet dupliqué, l'erreur -9802 est générée ("Chemin d'objet non unique"). Il est recommandé dans ce cas d'utiliser le CSM afin de vérifier la structure de la base de données.

Liste de tous les objets du formulaire "input" de la table [Emp]. A noter que les méthodes formulaire table (et les méthodes formulaire projet) sont traitées comme des objets appartenant au formulaire :

 METHODE LIRE CHEMINS FORM([Emp];tabChemins;"input")
  // Contenu de tabChemins (par exemple)
  // [tableForm]/input/{formMethod} -> Méthode formulaire
  // [tableForm]/input/bOK -> Méthode objet
  // [tableForm]/input/bCancel -> Méthode objet

Liste des objets du formulaire projet "dial" :

 METHODE LIRE CHEMINS FORM(tabChemins;"dial")

Liste de tous les objets des formulaires "input" de la table [Emp] à partir d’un composant :

 METHODE LIRE CHEMINS FORM(([Emp];tabChemins;"input@";*)

 
PROPRIÉTÉS 

Produit : 4D
Thème : Accès objets développement
Numéro : 1168
Nom intl. : METHOD GET PATHS FORM

 
HISTORIQUE 

Créé : 4D v13

 
VOIR AUSSI  

FORM LIRE NOMS

 
UTILISATION DE L'ARTICLE

4D - Langage ( 4D v14 R2)
4D - Langage ( 4D v14 R3)
4D - Langage ( 4D v13.5)
4D - Langage ( 4D v14.3)
4D - Langage ( 4D v14 R4)