4D Doc Center : LISTE DES DOCUMENTS

4D v14.3

LISTE DES DOCUMENTS


LISTE DES DOCUMENTS ( cheminAccès ; documents {; options} )

Paramètre	Type	Description
cheminAccès	Chaîne	Chemin d'accès de volume ou de dossier
documents	Tableau texte	Nom des documents situés à cet endroit
options	Entier long	Options de construction de la liste

Description

La commande LISTE DES DOCUMENTS remplit le tableau de type Texte documents avec les noms des documents situés à l'endroit que vous avez indiqué avec le paramètre cheminAccès.

Note : Vous devez passer un chemin d'accès absolu dans le paramètre cheminAccès.

Par défaut, si vous omettez le paramètre options, seuls les noms des documents sont retournés dans le tableau documents. Vous pouvez modifier ce fonctionnement en passant dans le paramètre options une ou plusieurs des constantes suivantes, placées dans le thème Documents système :

Constante	Type	Valeur	Commentaire
Chemin absolu	Entier long	2	Le tableau documents contient des chemins d’accès absolus
Chemin POSIX	Entier long	4	Le tableau documents contient des chemins d’accès au format POSIX
Chemin récursif	Entier long	1	Le tableau documents contient les fichiers et tous les sous-dossiers du dossier spécifié
Ignorer invisibles	Entier long	8	Les documents invisibles ne sont pas listés

Notes :

Avec l’option Chemin récursif en mode relatif (option 1 seule), les chemins des documents situés dans des sous-dossiers débutent par les caractères ":" ou "\" en fonction de la plate-forme.
Avec l’option Chemin POSIX en mode relatif (option 4 seule), les chemins ne débutent pas par "/"
Avec l’option Chemin POSIX en mode absolu (option 4 + 2), les chemins débutent toujours par "/"

S'il n'y pas de document à l'endroit défini, la commande retourne un tableau vide. Si le chemin d'accès que vous avez passé dans cheminAccès est invalide, LISTE DES DOCUMENTS génère une erreur de gestionnaire de fichier que vous pouvez intercepter à l'aide d'une méthode installée par APPELER SUR ERREUR.

Exemple 1

Liste de tous les documents dans un dossier (syntaxe par défaut) :

LISTE DES DOCUMENTS("C:\\";tabFichiers)

-> tabFichiers :
Texte1.txt
Texte2.txt

Exemple 2

Liste de tous les documents dans un dossier en mode absolu :

LISTE DES DOCUMENTS("C:\\";tabFichiers; Chemin absolu)

-> tabFichiers :
C:\Texte1.txt
C:\Texte2.txt

Exemple 3

Liste de tous les documents en mode récursif (relatif) :

LISTE DES DOCUMENTS("C:\\";tabFichiers;Chemin récursif)

-> tabFichiers :
       Texte1.txt
       Texte2.txt
       \Dossier1\Texte3.txt
       \Dossier1\Texte4.txt
       \Dossier2\Texte5.txt
       \Dossier2\Dossier3\Image1.png

Exemple 4

Liste de tous les documents en mode récursif absolu :

LISTE DES DOCUMENTS("C:\\MonDossier\\";tabFichiers;Chemin récursif+Chemin absolu)

-> tabFichiers :
       C:\MonDossier\MonTexte1.txt
       C:\MonDossier\MonTexte2.txt
       C:\MonDossier\Dossier1\MonTexte3.txt
       C:\MonDossier\Dossier1\MonTexte4.txt
       C:\MonDossier\Dossier2\MonTexte5.txt
       C:\MonDossier\Dossier2\Dossier3\MonImage1.png

Exemple 5

Liste de tous les documents en mode récursif POSIX (relatif) :

LISTE DES DOCUMENTS("C:\\MonDossier\\";tabFichiers;Chemin récursif+Chemin POSIX)

-> tabFichiers :
       MonTexte1.txt
       MonTexte2.txt
       Dossier1/MonTexte3.txt
       Dossier1/MonTexte4.txt
       Dossier2/MonTexte5.txt
       Dossier2/Dossier3/MonImage1.png