4D v14.3

FORM LIRE NOMS

Accueil

 
4D v14.3
FORM LIRE NOMS

FORM LIRE NOMS 


 

FORM LIRE NOMS ( {laTable ;} tabNoms {; filtre {; marqueur}}{; *} ) 
Paramètre Type   Description
laTable  Table in Référence de table
tabNoms  Tableau texte in Tableau des noms de formulaires
filtre  Texte in Filtrage des noms
marqueur  Entier long in Marqueur de version minimale à retourner
in Nouvelle valeur
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 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.

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;*)

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;*)

 
PROPRIÉTÉS 

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

 
HISTORIQUE 

New
Créé : 4D v13
Modifié : 4D v14

 
VOIR AUSSI  

METHODE LIRE CHEMINS FORM

 
UTILISATION DE L'ARTICLE

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

Hérité de : FORM LIRE NOMS ( 4D v13.5)