4D v14.3
FORM LIRE NOMS
- 4D - Langage
-
- Accès objets développement
-
- Commandes du thème Accès objets développement
- Chemin methode courante
- FORM LIRE NOMSMod
- METHODE FIXER ATTRIBUTMod
- METHODE FIXER CODEMod
- METHODE FIXER COMMENTAIRES
- METHODE FIXER MODE ACCES
- METHODE Lire attribut
- METHODE Lire chemin
- METHODE LIRE CHEMINS
- METHODE LIRE CHEMINS FORM
- METHODE LIRE CODEMod
- METHODE LIRE COMMENTAIRES
- METHODE LIRE DATE MODIFICATION
- METHODE LIRE DOSSIERS
- METHODE LIRE NOMS
- METHODE OUVRIR CHEMIN
- METHODE RESOUDRE CHEMIN
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 | Entier long |
|
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) | |||||
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;*)
Produit : 4D
Thème : Accès objets développement
Numéro :
1167
Nom intl. : FORM GET NAMES
Créé : 4D v13
Modifié : 4D v14
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)
