Clase Directory
.creationDate
Histórico
| Versión | Modificaciones |
|---|---|
| v17 R5 | Añadidos |
.creationDate : Date
Descripción
La propiedad .creationDate devuelve la fecha de creación de la carpeta.
Esta propiedad es de sólo lectura.
.creationTime
Histórico
| Versión | Modificaciones |
|---|---|
| v17 R5 | Añadidos |
.creationTime : Time
Descripción
La propiedad .creationTime devuelve la hora de creación de la carpeta (expresado como un número de segundos que comienza en 00:00).
Esta propiedad es de sólo lectura.
.exists
Histórico
| Versión | Modificaciones |
|---|---|
| v17 R5 | Añadidos |
.exists : Boolean
Descripción
La propiedad .exists devuelve true si la carpeta existe en el disco, y false en caso contrario.
Esta propiedad es de sólo lectura.
.extension
Histórico
| Versión | Modificaciones |
|---|---|
| v17 R5 | Añadidos |
.extension : Text
Descripción
La propiedad .extension devuelve la extensión del nombre de la carpeta (si la hay). Una extensión siempre comienza por ".". La propiedad devuelve una cadena vacía si el nombre de la carpeta no tiene extensión.
Esta propiedad es de sólo lectura.
.fullName
Histórico
| Versión | Modificaciones |
|---|---|
| v17 R5 | Añadidos |
.fullName : Text
Descripción
La propiedad .fullName devuelve el nombre completo de la carpeta, incluida su extensión (si la hay).
Esta propiedad es de sólo lectura.
.hidden
Histórico
| Versión | Modificaciones |
|---|---|
| v17 R5 | Añadidos |
.hidden : Boolean
Descripción
La propiedad .hidden devuelve true si la carpeta está definida como "oculta" a nivel del sistema, y false en caso contrario.
Esta propiedad es de sólo lectura.
.isAlias
Histórico
| Versión | Modificaciones |
|---|---|
| v17 R5 | Añadidos |
.isAlias : Boolean
Descripción
La propiedad .isAlias devuelve siempre false para un objeto Folder.
Esta propiedad es de sólo lectura.
.isFile
Histórico
| Versión | Modificaciones |
|---|---|
| v17 R5 | Añadidos |
.isFile : Boolean
Descripción
La propiedad .isFile devuelve siempre false para una carpeta.
Esta propiedad es de sólo lectura.
.isFolder
Histórico
| Versión | Modificaciones |
|---|---|
| v17 R5 | Añadidos |
.isFolder : Boolean
Descripción
La propiedad .isFolder devuelve siempre true para una carpeta.
Esta propiedad es de sólo lectura.
.isPackage
Histórico
| Versión | Modificaciones |
|---|---|
| v17 R5 | Añadidos |
.isPackage : Boolean
Descripción
La propiedad .isPackage devuelve true si la carpeta es un paquete en macOS (y existe en el disco). En caso contrario, devuelve false.
En Windows, .isPackage siempre devuelve false.
Esta propiedad es de sólo lectura.
.modificationDate
Histórico
| Versión | Modificaciones |
|---|---|
| v17 R5 | Añadidos |
.modificationDate : Date
Descripción
La propiedad .modificationDate devuelve la fecha de la última modificación de la carpeta.
Esta propiedad es de sólo lectura.
.modificationTime
Histórico
| Versión | Modificaciones |
|---|---|
| v17 R5 | Añadidos |
.modificationTime : Time
Descripción
La propiedad .modificationTime devuelve la hora de la última modificación de la carpeta (expresado como un número de segundos que comienza en 00:00).
Esta propiedad es de sólo lectura.
.name
Histórico
| Versión | Modificaciones |
|---|---|
| v17 R5 | Añadidos |
.name : Text
Descripción
La propiedad .name devuelve el nombre de la carpeta, sin extensión (si la hay).
Esta propiedad es de sólo lectura.
.original
Histórico
| Versión | Modificaciones |
|---|---|
| v17 R5 | Añadidos |
.original : 4D.Folder
Descripción
La propiedad .original devuelve el mismo objeto Folder que la carpeta.
Esta propiedad es de sólo lectura.
Esta propiedad está disponible en las carpetas para permitir que el código genérico procese carpetas o archivos.
.parent
Histórico
| Versión | Modificaciones |
|---|---|
| v17 R5 | Añadidos |
.parent : 4D.Folder
Descripción
La propiedad .parent devuelve el objeto carpeta padre de la carpeta. Si la ruta representa una ruta del sitema (por ejemplo, "/DATA/"), se devuelve la ruta del sistema.
Si la carpeta no tiene un padre (raíz), se devuelve el valor null.
Esta propiedad es de sólo lectura.
.path
Histórico
| Versión | Modificaciones |
|---|---|
| v17 R5 | Añadidos |
.path : Text
Descripción
La propiedad .path devuelve la ruta POSIX de la carpeta. Si la ruta representa un filesystem (por ejemplo, "/DATA/"), se devuelve el filesystem.
Esta propiedad es de sólo lectura.
.platformPath
Histórico
| Versión | Modificaciones |
|---|---|
| v17 R5 | Añadidos |
.platformPath : Text
Descripción
La propiedad .platformPath devuelve la ruta de la carpeta expresada con la sintaxis de la plataforma actual.
Esta propiedad es de sólo lectura.
.copyTo()
Histórico
| Versión | Modificaciones |
|---|---|
| v17 R5 | Añadidos |
.copyTo( destinationFolder : 4D.Folder { ; newName : Text } { ; overwrite : Integer } ) : 4D.Folder
| Parámetros | Tipo | Descripción | |
|---|---|---|---|
| destinationFolder | 4D.Folder | -> | Carpeta de destino |
| newName | Text | -> | Nombre para la copia |
| overwrite | Integer | -> | fk overwrite para sustituir los elementos existentes |
| Result | 4D.Folder | <- | Carpeta o archivo copiado |
|
Descripción
La función .copyTo() copia el objeto Folder en el objeto destinationFolder especificado.
La destinationFolder debe existir en el disco, de lo contrario se genera un error.
Por defecto, la carpeta se copia con el nombre de la carpeta original. Si desea cambiar el nombre de la copia, pase el nuevo nombre en el parámetro newName. El nuevo nombre debe cumplir con las reglas de nomenclatura (por ejemplo, no debe contener caracteres como ":", "/", etc.), de lo contrario se devuelve un error.
Si ya existe una carpeta con el mismo nombre en la destinationFolder, por defecto 4D genera un error. Puede pasar la constante fk overwrite en el parámetro overwrite para ignorar y sobrescribir el archivo existente
| Constante | Valor | Comentario |
|---|---|---|
fk overwrite | 4 | Sobrescribir los elementos existentes, si los hay |
Valor devuelto
El objeto Folder copiado.
Ejemplo
Desea copiar una carpeta Imágenes de la carpeta de documentos del usuario a la carpeta 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()
Histórico
| Versión | Modificaciones |
|---|---|
| v17 R5 | Añadidos |
.file( path : Text ) : 4D.File
| Parámetros | Tipo | Descripción | |
|---|---|---|---|
| path | Text | -> | Ruta POSIX relativa |
| Result | 4D.File | <- | Objeto File (null si la ruta no es válida) |
|
Descripción
La función .file() crea un objeto File dentro del objeto Folder y devuelve su referencia.
En path, pase una ruta relativa POSIX para designar el archivo a devolver. La ruta se evaluará a partir de la carpeta padre como raíz.
Valor devuelto
Un objeto File o null si path no es válido.
Ejemplo
var $myPDF : 4D.File
$myPDF:=Folder(fk documents folder).file("Pictures/info.pdf")
.files()
Histórico
| Versión | Modificaciones |
|---|---|
| v17 R5 | Añadidos |
.files( { options : Integer } ) : Collection
| Parámetros | Tipo | Descripción | |
|---|---|---|---|
| options | Integer | -> | Opciones de la lista de archivos |
| Result | Collection | <- | Colección de objetos de archivo hijo |
|
Descripción
La función .files() devuelve una colección de objetos File contenidos en la carpeta.
Los alias o enlaces simbólicos no se resuelven.
Por defecto, si se omite el parámetro options, sólo se devuelven en la colección los archivos del primer nivel de la carpeta, así como los archivos o carpetas invisibles. Puede modificar esto pasando, en el parámetro options, una o varias de las siguientes constantes:
| Constante | Valor | Comentario |
|---|---|---|
fk recursive | 1 | La colección contiene los archivos de la carpeta especificada y sus subcarpetas |
fk ignore invisible | 8 | Los archivos invisibles no aparecen en la lista |
Valor devuelto
Colección de objetos File.
Ejemplo 1
Quiere saber si hay archivos invisibles en la carpeta 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
End if
Ejemplo 2
Quiere obtener todos los archivos que no son invisibles en la carpeta Documents:
var $recursive : Collection
$recursive:=Folder(fk documents folder).files(fk recursive+fk ignore invisible)
.folder()
Histórico
| Versión | Modificaciones |
|---|---|
| v17 R5 | Añadidos |
.folder( path : Text ) : 4D.Folder
| Parámetros | Tipo | Descripción | |
|---|---|---|---|
| path | Text | -> | Ruta POSIX relativa |
| Result | 4D.Folder | <- | Objeto carpeta creado (null si pathno es válido) |
|
Descripción
La función .folder() crea un objeto Folder dentro del objeto padre Folder y devuelve su referencia.
En path, pase una ruta relativa POSIX para designar la carpeta a devolver. La ruta se evaluará a partir de la carpeta padre como raíz.
Valor devuelto
Un objeto Folder o null si path no es válido.
Ejemplo
var $mypicts : 4D.Folder
$mypicts:=Folder(fk documents folder).folder("Pictures")
.folders()
Histórico
| Versión | Modificaciones |
|---|---|
| v17 R5 | Añadidos |
.folders( { options : Integer } ) : Collection
| Parámetros | Tipo | Descripción | |
|---|---|---|---|
| options | Integer | -> | Opciones de la lista de carpetas |
| Result | Collection | <- | Colección de objetos de carpeta hijo |
|
Descripción
La función .folders() devuelve una colección de objetos Folder contenidos en la carpeta padre.
Por defecto, si se omite el parámetro options, sólo se devuelven en la colección las carpetas del primer nivel de la carpeta. Puede modificar esto pasando, en el parámetro options, una o varias de las siguientes constantes:
| Constante | Valor | Comentario |
|---|---|---|
fk recursive | 1 | La colección contiene las carpetas de la carpeta especificada y sus subcarpetas |
fk ignore invisible | 8 | Los archivos invisibles no aparecen en la lista |
Valor devuelto
Colección de objetos Folder.
Ejemplo
Quiere obtener la colección de todas las carpetas y subcarpetas de la carpeta de la base:
var $allFolders : Collection
$allFolders:=Folder("/PACKAGE").folders(fk recursive)
.getIcon()
Histórico
| Versión | Modificaciones |
|---|---|
| v17 R5 | Añadidos |
.getIcon( { size : Integer } ) : Picture
| Parámetros | Tipo | Descripción | |
|---|---|---|---|
| size | Integer | -> | Longitud del lado de la imagen devuelta (píxeles) |
| Result | Picture | <- | Icono |
|
Descripción
La función .getIcon() devuelve el icono de la carpeta.
El parámetro opcional size especifica las dimensiones en píxeles del icono devuelto. Este valor representa en realidad la longitud del lado del cuadrado que contiene el icono. Los iconos suelen definirse en 32x32 píxeles ("iconos grandes") o 16x16 píxeles ("iconos pequeños"). Si pasa 0 u omite este parámetro, se devuelve la versión "icono grande".
Si la carpeta no existe en el disco, se devuelve un icono vacío por defecto.
Valor devuelto
Imagen del icono de la carpeta.