FORM LIRE NOMS

4D v20 R7

FORM LIRE NOMS


FORM LIRE NOMS ( {laTable ;} tabNoms {; filtre {; marqueur}}{; *} )

Paramètre	Type	Description
laTable	Table	Référence de table
tabNoms	Tableau texte	Tableau des noms de formulaires
filtre	Texte	Filtrage des noms
marqueur	Variable réel	Marqueur de version minimale à retourner
		Nouvelle valeur
*	Opérateur	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)

Description

La commande FORM LIRE NOMS remplit le tableau tabNoms avec les noms des formulaires de l’application.

Si vous passez le paramètre laTable, la commande retourne les noms des formulaires table associés à cette table. Si vous omettez ce paramètre, le commande retourne les noms 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é.

Vous pouvez également restreindre la liste des formulaires à l'aide du paramètre optionnel marqueur. Ce paramètre permet de limiter les formulaires retournés dans tabNoms à ceux qui ont été modifiés ultérieurement à un instant donné. Dans le cadre d’un système de contrôle de version, ce paramètre vous permet de ne mettre à jour que les formulaires ayant été modifiés depuis la dernière sauvegarde.
Ce principe fonctionne de la manière suivante : 4D maintient en interne un compteur de modification des ressources de la base. Les formulaires étant des ressources, chaque fois qu’un formulaire est créé ou réenregistré, ce compteur est incrémenté. Si vous passez le paramètre marqueur, la commande retourne dans tabNoms uniquement les formulaires correspondant à des valeurs de marqueurs supérieures ou égales à celle de marqueur. En outre, si vous passez une variable dans marqueur, la commande retourne dans cette variable la nouvelle valeur du compteur de modification, c’est-à-dire la plus élevée. Vous pouvez alors sauvegarder cette valeur et l’utiliser lors du prochain appel de la commande FORM LIRE NOMS afin de ne récupérer que les formulaires nouveaux ou modifiés.

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

Note : Les formulaires placés dans la corbeille ne sont pas listés.

Exemple

Exemples d’utilisations type :

  // Liste de tous les formulaires projet de la base

 FORM LIRE NOMS(t_Noms)

 

     // Liste des formulaires de la table [Emps]

 FORM LIRE NOMS([Emps];t_Noms)

 

     // Liste des formulaires "input" de la table [Emps]

 FORM LIRE NOMS([Emps];t_Noms;"input_@")

 

     // Liste de formulaires projet spécifiques de la base

 FORM LIRE NOMS(t_Noms;"dialogue_@")

 

  // Liste de tous les formulaires projet de la base modifiés depuis la dernière synchronisation

  // vMarqueur contient une valeur numérique

 FORM LIRE NOMS(t_Noms;"";vMarqueur)

 

     // Liste de formulaires table depuis un composant

     // Un pointeur est requis car le nom de la table est inconnu

 FORM LIRE NOMS(tablePtr->;t_Noms;*)

Voir aussi

Formulaires
METHODE LIRE CHEMINS FORM