Classe Directory
.creationDate
Historique
| Release | Modifications |
|---|---|
| 17 R5 | Ajout |
.creationDate : Date
Description
La propriété .creationDate retourne la date de création du dossier.
Cette propriété est en lecture seule.
.creationTime
Historique
| Release | Modifications |
|---|---|
| 17 R5 | Ajout |
.creationTime : Time
Description
La propriété .creationTime renvoie l'heure de création du dossier (exprimée en nombre de secondes commençant à 00:00).
Cette propriété est en lecture seule.
.exists
Historique
| Release | Modifications |
|---|---|
| 17 R5 | Ajout |
.exists : Boolean
Description
La propriété .exists renvoie true si le dossier existe sur le disque, et false sinon.
Cette propriété est en lecture seule.
.extension
Historique
| Release | Modifications |
|---|---|
| 17 R5 | Ajout |
.extension : Text
Description
La propriété .extension renvoie l'extension du nom du dossier (s'il y en a une). Une extension commence toujours par ".". La propriété retourne une chaîne vide si le nom du dossier n'a pas d'extension.
Cette propriété est en lecture seule.
.fullName
Historique
| Release | Modifications |
|---|---|
| 17 R5 | Ajout |
.fullName : Text
Description
La propriété .fullName retourne le nom complet du dossier, extension comprise (le cas échéant).
Cette propriété est en lecture seule.
.hidden
Historique
| Release | Modifications |
|---|---|
| 17 R5 | Ajout |
.hidden : Boolean
Description
La propriété .hidden renvoie true si le dossier est défini comme "hidden" au niveau du système, et false dans le cas contraire.
Cette propriété est en lecture seule.
.isAlias
Historique
| Release | Modifications |
|---|---|
| 17 R5 | Ajout |
.isAlias : Boolean
Description
La propriété .isAlias retournetoujours false pour un objet Dossier.
Cette propriété est en lecture seule.
.isFile
Historique
| Release | Modifications |
|---|---|
| 17 R5 | Ajout |
.isFile : Boolean
Description
La propriété .isFile retourne toujours false pour un dossier.
Cette propriété est en lecture seule.
.isFolder
Historique
| Release | Modifications |
|---|---|
| 17 R5 | Ajout |
.isFolder : Boolean
Description
La propriété .isFolder renvoie toujours true pour un dossier.
Cette propriété est en lecture seule.
.isPackage
Historique
| Release | Modifications |
|---|---|
| 17 R5 | Ajout |
.isPackage : Boolean
Description
La propriété .isPackage renvoie true si le dossier est un paquet sous macOS (et existe sur le disque). Sinon, elle retourne false.
Sous Windows, .isPackage retourne toujours false.
Cette propriété est en lecture seule.
.modificationDate
Historique
| Release | Modifications |
|---|---|
| 17 R5 | Ajout |
.modificationDate : Date
Description
La propriété .modificationDate renvoie la date de la dernière modification du dossier.
Cette propriété est en lecture seule.
.modificationTime
Historique
| Release | Modifications |
|---|---|
| 17 R5 | Ajout |
.modificationTime : Time
Description
La propriété .modificationTime retourne l'heure de la dernière modification du dossier (exprimée en nombre de secondes depuis 00:00).
Cette propriété est en lecture seule.
.name
Historique
| Release | Modifications |
|---|---|
| 17 R5 | Ajout |
.name : Text
Description
La propriété .name renvoie le nom du dossier, sans l'extension (s'il y en a une).
Cette propriété est en lecture seule.
.original
Historique
| Release | Modifications |
|---|---|
| 17 R5 | Ajout |
.original : 4D.Folder
Description
La propriété .original retourne le même objet Dossier que le dossier.
Cette propriété est en lecture seule.
Cette propriété est disponible sur les dossiers pour permettre au code générique de traiter les dossiers ou les fichiers.
.parent
Historique
| Release | Modifications |
|---|---|
| 17 R5 | Ajout |
.parent : 4D.Folder
Description
La propriété .parent retourne l'objet dossier parent du dossier. Si le chemin représente un filesystem (ex : "/DATA/"), le filesystem est retourné.
Si le dossier n'a pas de parent (racine), la valeur nulle est retournée.
Cette propriété est en lecture seule.
.path
Historique
| Release | Modifications |
|---|---|
| 17 R5 | Ajout |
.path : Text
Description
La propriété .path retourne le chemin POSIX du dossier. Si le chemin représente un filesystem (ex : "/DATA/"), le filesystem est retourné.
Cette propriété est en lecture seule.
.platformPath
Historique
| Release | Modifications |
|---|---|
| 17 R5 | Ajout |
.platformPath : Text
Description
La propriété .platformPath retourne le chemin du dossier exprimé dans la syntaxe de la plate-forme courante.
Cette propriété est en lecture seule.
.copyTo()
Historique
| Release | Modifications |
|---|---|
| 17 R5 | Ajout |
.copyTo( destinationFolder : 4D.Folder { ; newName : Text } { ; overwrite : Integer } ) : 4D.Folder
| Paramètres | Type | Description | |
|---|---|---|---|
| dossierDestination | 4D.Folder | -> | Dossier de destination |
| nouveauNom | Text | -> | Nom de la copie |
| overwrite | Integer | -> | fk overwrite pour écraser les éléments existants |
| Résultat | 4D.Folder | <- | Dossier copié |
Description
La fonction .copyTo() copie l'objet Folder dans le destinationFolder spécifié.
Le destinationFolder doit exister sur disque, sinon une erreur est générée.
Par défaut, le dossier est copié avec le nom du dossier original. Si vous souhaitez renommer la copie, passez le nouveau nom dans le paramètre newName. Le nouveau nom doit être conforme aux règles de nommage (ex : il ne doit pas contenir de caractères tels que ":", "/", etc.), sinon une erreur est retournée.
S'il existe déjà un dossier portant le même nom dans destinationFolder, par défaut 4D génère une erreur. Vous pouvez passer la constante fk overwrite dans le paramètre overwrite pour ignorer et écraser le dossier existant :
| Constante | Valeur | Commentaire |
|---|---|---|
fk overwrite | 4 | Écrase les éléments existants, le cas échéant |
Valeur retournée
L'objet Folder copié.
Exemple
Vous souhaitez copier un dossier Pictures, à partir du dossier Document de l'utilisateur vers le dossier de la base :
var $userImages; $copiedImages : 4D.Folder
$userImages:=Folder(fk documents folder).folder("Pictures")
$copiedImages:=$userImages.copyTo(Folder(fk database folder);fk overwrite)
.file()
Historique
| Release | Modifications |
|---|---|
| 17 R5 | Ajout |
.file( path : Text ) : 4D.File
| Paramètres | Type | Description | |
|---|---|---|---|
| path | Text | -> | Chemin POSIX relatif |
| Résultat | 4D.File | <- | Objet File (null si chemin invalide) |
Description
La fonction .file() crée un objet File à l'intérieur de l'objet Folder et retourne sa référence.
Dans le paramètre path, passez un chemin relatif POSIX pour désigner le fichier à retourner. Le chemin sera évalué à partir du dossier parent en tant que racine.
Valeur retournée
Un objet File ou null si path n'est pas valide.
Exemple
var $myPDF : 4D.File
$myPDF:=Folder(fk documents folder).file("Pictures/info.pdf")
.files()
Historique
| Release | Modifications |
|---|---|
| 17 R5 | Ajout |
.files( { options : Integer } ) : Collection
| Paramètres | Type | Description | |
|---|---|---|---|
| options | Integer | -> | Options de liste de fichiers |
| Résultat | Collection | <- | Collection d'objets dossier enfant |
Description
La fonction .files() retourne une collection d'objets File contenus dans le dossier.
Les alias ou les liens symboliques ne sont pas résolus.
Par défaut, si vous omettez le paramètre options, seuls les fichiers à la racine du dossier sont retournés dans la collection, ainsi que les fichiers et dossiers invisibles. Vous pouvez modifier cela en passant, dans le paramètre options parameter, une ou plusieurs des constantes suivantes :
| Constante | Valeur | Commentaire |
|---|---|---|
fk recursive | 1 | La collection contient les fichiers du dossier spécifié ainsi que de ses sous-dossiers |
fk ignore invisible | 8 | Les fichiers invisibles ne sont pas répertoriés |
Valeur retournée
Collection d'objets File.
Exemple 1
Vous souhaitez savoir s'il y a des fichiers invisibles dans le dossier de la base :
var $all; $noInvisible : Collection
$all:=Folder(fk database folder).files()
$noInvisible:=Folder(fk database folder).files(fk ignore invisible)
If($all.length#$noInvisible.length)
ALERT("Database folder contains hidden files.")
End if
Exemple 2
Vous souhaitez lire tous les fichiers qui ne sont pas invisibles dans le dossier Documents :
var $recursive : Collection
$recursive:=Folder(fk documents folder).files(fk recursive+fk ignore invisible)
.folder()
Historique
| Release | Modifications |
|---|---|
| 17 R5 | Ajout |
.folder( path : Text ) : 4D.Folder
| Paramètres | Type | Description | |
|---|---|---|---|
| path | Text | -> | Chemin POSIX relatif |
| Résultat | 4D.Folder | <- | Objet dossier (null si path invalide) |
Description
La fonction .folder() crée un objet Folder à l'intérieur de l'objet parent Folder et retourne sa référence.
Dans le paramètre path, passez un chemin relatif POSIX pour désigner le dossier à retourner. Le chemin sera évalué à partir du dossier parent en tant que racine.
Valeur retournée
Un objet Folder object ou null si path est invalide.
Exemple
var $mypicts : 4D.Folder
$mypicts:=Folder(fk documents folder).folder("Pictures")
.folders()
Historique
| Release | Modifications |
|---|---|
| 17 R5 | Ajout |
.folders( { options : Integer } ) : Collection
| Paramètres | Type | Description | |
|---|---|---|---|
| options | Integer | -> | Options de liste des dossiers |
| Résultat | Collection | <- | Collection d'objets dossier enfant |
Description
La fonction .folders() retourne une collection d'objets Folder contenus dans le dossier parent.
Par défaut, si vous omettez le paramète options, seuls les dossiers à la racine du dossier sont retournés dans la collection. Vous pouvez modifier cela en passant, dans le paramètre options parameter, une ou plusieurs des constantes suivantes :
| Constante | Valeur | Commentaire |
|---|---|---|
fk recursive | 1 | La collection contient les dossiers du dossier spécifié ainsi que de ses sous-dossiers |
fk ignore invisible | 8 | Les dossiers invisibles ne sont pas répertoriés |
Valeur retournée
Collection d'objets Folder.
Exemple
Vous souhaitez obtenir la collection de tous les dossiers et sous-dossiers du dossier de la base :
var $allFolders : Collection
$allFolders:=Folder("/PACKAGE").folders(fk recursive)
.getIcon()
Historique
| Release | Modifications |
|---|---|
| 17 R5 | Ajout |
.getIcon( { size : Integer } ) : Picture
| Paramètres | Type | Description | |
|---|---|---|---|
| size | Integer | -> | Longueur du côté de l'image retournée (pixels) |
| Résultat | Picture | <- | Icône |
Description
La fonction .getIcon() retourne l'icône du dossier.
Le paramètre optionnel size spécifie les dimensions en pixels de l'icône retournée. Cette valeur représente la longueur latérale du côté du carré contenant l'icône. La taille des icônes est généralement de 32x32 pixels (“grandes icônes”) ou de 16x16 pixels (“petites icônes”). Si vous passez 0 ou si vous omettez ce paramètre, la version "grandes icônes" est retournée.
Si le dossier n'existe pas sur disque, une icône vide est retournée par défaut.
Valeur retournée
Image de l'icône du dossier.