Directory Class
.creationDate
Histórico
| Release | Mudanças |
|---|---|
| 17 R5 | Adicionado |
.creationDate : Date
Descrição
A propriedade .aceita a transação devolve a data de criação da pasta.
Essa propriedade é apenas leitura.
.creationTime
Histórico
| Release | Mudanças |
|---|---|
| 17 R5 | Adicionado |
.creationTime : Time
Descrição
A propriedade .creationTime devolve a hora da criação da pasta (expresso como um número de segundos a partir das 00:00).
Essa propriedade é apenas leitura.
.exists
Histórico
| Release | Mudanças |
|---|---|
| 17 R5 | Adicionado |
.exists : Boolean
Descrição
A propriedade .exists devolve true se a pasta existir no discoe false de outra forma.
Essa propriedade é apenas leitura.
.extension
Histórico
| Release | Mudanças |
|---|---|
| 17 R5 | Adicionado |
.extension : Text
Descrição
A propriedade .extension devolve a extensão do nome da pasta (se houver). Uma extensão sempre começa com ".". Uma extensão sempre começa com "." A propriedade devolve uma string vazia se o nome da pasta não tiver extensão.
Essa propriedade é apenas leitura.
.fullName
Histórico
| Release | Mudanças |
|---|---|
| 17 R5 | Adicionado |
.fullName : Text
Descrição
A propriedade .fullName devolve o nome completo da pasta, incluindo a sua extensão (se houver).
Essa propriedade é apenas leitura.
.hidden
Histórico
| Release | Mudanças |
|---|---|
| 17 R5 | Adicionado |
.hidden : Boolean
Descrição
A propriedade .size devolve true se a pasta for definida como "escondida" ao nível do sistemae false de outra forma.
Essa propriedade é apenas leitura.
.isAlias
Histórico
| Release | Mudanças |
|---|---|
| 17 R5 | Adicionado |
.isAlias : Boolean
Descrição
A propriedade .isAlias devolve sempre false para um objecto Folder.
Essa propriedade é apenas leitura.
.isFile
Histórico
| Release | Mudanças |
|---|---|
| 17 R5 | Adicionado |
.isFile : Boolean
Descrição
A propriedade .isFile devolve sempre false para uma pasta.
Essa propriedade é apenas leitura.
.isFolder
Histórico
| Release | Mudanças |
|---|---|
| 17 R5 | Adicionado |
.isFolder : Boolean
Descrição
A propriedade .isFolder devolve sempretrue para uma pasta.
Essa propriedade é apenas leitura.
.isPackage
Histórico
| Release | Mudanças |
|---|---|
| 17 R5 | Adicionado |
.isPackage : Boolean
Descrição
A propriedade .isPackage devolve true se a pasta for um pacote em macOS (e existir em disco). .
Em Windows, .isPackage sempre devolve false.
Essa propriedade é apenas leitura.
.modificationDate
Histórico
| Release | Mudanças |
|---|---|
| 17 R5 | Adicionado |
.modificationDate : Date
Descrição
A propriedade .modificationDate devolve a data da última modificação da pasta.
Essa propriedade é apenas leitura.
.modificationTime
Histórico
| Release | Mudanças |
|---|---|
| 17 R5 | Adicionado |
.modificationTime : Time
Descrição
A propriedade .modificationTime devolve a hora da última modificação da pasta (expresso como um número de segundos a partir das 00:00).
Essa propriedade é apenas leitura.
.name
Histórico
| Release | Mudanças |
|---|---|
| 17 R5 | Adicionado |
.name : Text
Descrição
A propriedade .name devolve o nome da pasta, sem extensão (se houver).
Essa propriedade é apenas leitura.
.original
Histórico
| Release | Mudanças |
|---|---|
| 17 R5 | Adicionado |
.original : 4D. Folder
Descrição
A propriedade .original devolve o mesmo objecto Folder que a pasta.
Essa propriedade é apenas leitura.
Esta propriedade está disponible nas pastas para permitir que o código genérico processe pastas ou arquivos.
.parent
Histórico
| Release | Mudanças |
|---|---|
| 17 R5 | Adicionado |
.parent : 4D. Folder
Descrição
A propriedade .parent devolve o objecto Folder pai da pasta. .
Se a pasta não tiver um pai (raiz), é devolvido o valor nulo.
Essa propriedade é apenas leitura.
.path
Histórico
| Release | Mudanças |
|---|---|
| 17 R5 | Adicionado |
.path : Text
Descrição
A propriedade .path devolve o caminho POSIX da pasta. .
Essa propriedade é apenas leitura.
.platformPath
Histórico
| Release | Mudanças |
|---|---|
| 17 R5 | Adicionado |
.platformPath : Text
Descrição
A propriedade .platformPath devolve o caminho da pasta expresso com a sintaxe da plataforma actual.
Essa propriedade é apenas leitura.
.copyTo()
Histórico
| Release | Mudanças |
|---|---|
| 17 R5 | Adicionado |
.copyTo( destinationFolder : 4D. Folder { ; newName : Text } { ; overwrite : Integer } ) : 4D. Folder
| Parâmetro | Tipo | Descrição | |
|---|---|---|---|
| destinationFolder | 4D. Folder | -> | Pasta de destino |
| newName | Text | -> | Nome para a copia |
| overwrite | Integer | -> | fk overwrite para substituir os elementos existentes |
| Resultados | 4D. Folder | <- | Pasta ou arquivo copiado |
|
Descrição
A função .copyTo() copia o objecto Folder para o objecto especificado destinationFolder.
A destinationFolder deve existir em disco, senão um erro é gerado.
Como padrão, a pasta é copiada com o nome da pasta original. Se quiser renomear a cópia, passe o novo nome no parâmetro newName . O novo nome deve cumprir com as regras de nomenclatura (por exemplo, não deve conter caracteres como ":", "/", etc.), do contrário se devolve um erro.
Se já existir uma pasta com o mesmo nome em destinationFolder, por padrão 4D gera um erro. Pode passar a constante fk overwrite no parâmetro overwrite para ignorar e sobrescriber o arquivo existente
| Parâmetros | Valor | Comentário |
|---|---|---|
fk overwrite | 4 | Sobrescrever os elementos existentes, se houver |
Valor retornado
O objeto Folder copiado.
Exemplo
Se quiser copiar uma pasta Imágens da pasta de documentos do usuário a pasta da Database:
var $userImages; $copiedImages : 4D.Folder
$userImages:=Folder(fk documents folder).folder("Pictures")
$copiedImages:=$userImages.copyTo(Folder(fk database folder);fk overwrite)
.file()
Histórico
| Release | Mudanças |
|---|---|
| 17 R5 | Adicionado |
.file( path : Text ) : 4D. File
| Parâmetro | Tipo | Descrição | |
|---|---|---|---|
| path | Text | -> | Rota POSIX relativa |
| Resultados | 4D. File | <- | Objeto File (null se a rota não for válida) |
|
Descrição
A função .file() cria a objecto File dentro do objecto Folder e devolve a sua referência.
Em path, passe uma rota relativa POSIX para designar o arquivo a devolver. A rota se avaliará a partir da pasta pai como raíz.
Valor retornado
Um objeto File ou null se path não for válido.
Exemplo
var $myPDF : 4D. File
$myPDF:=Folder(fk documents folder).file("Pictures/info.pdf")
.files()
Histórico
| Release | Mudanças |
|---|---|
| 17 R5 | Adicionado |
.files( { options : Integer } ) : Collection
| Parâmetro | Tipo | Descrição | |
|---|---|---|---|
| options | Integer | -> | Opções da lista de arquivos |
| Resultados | Collection | <- | Coleção de objetos de arquivo filho |
|
Descrição
A função .files() devolve uma colecção dos objectos File contidos na pasta.
Os apelidos ou links simbolicos não são resolvidos.
Como padrão, se omitir o parâmetro options, só se devolvem na coleção os arquivos de primeiro nivel da pasta, assim como os arquivos ou pastas invisíveis. Pode modificar isso passando, no parâmetro options, uma ou várias das constantes abaixo:
| Parâmetros | Valor | Comentário |
|---|---|---|
fk recursive | 1 | A coleção contém arquivos da pasta especificada e suas subpastas |
fk ignore invisible | 8 | Arquivos invisíveis não estão listados |
Valor retornado
Coleção de objetos File.
Exemplo 1
Se quiser saber se há arquivos invisíveis na pasta Database:
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
End if
Exemplo 2
Se quiser obter todos os arquivos que não são invisíveis na pasta Documents:
var $recursive : Collection
$recursive:=Folder(fk documents folder).files(fk recursive+fk ignore invisible)
.folder()
Histórico
| Release | Mudanças |
|---|---|
| 17 R5 | Adicionado |
.folder( path : Text ) : 4D. Folder
| Parâmetro | Tipo | Descrição | |
|---|---|---|---|
| path | Text | -> | Rota POSIX relativa |
| Resultados | 4D. Folder | <- | Objeto pasta criado (null se pathnão for válido) |
|
Descrição
A função .folder() cria um objecto Folder dentro do objecto pai Folder e devolve a sua referência.
Em path, passe uma rota relativa POSIX para designar a pasta a devolver. A rota se avaliará a partir da pasta pai como raíz.
Valor retornado
Um objeto Folder ou null se path não for válido.
Exemplo
var $mypicts : 4D. Folder
$mypicts:=Folder(fk documents folder).folder("Pictures")
.folders()
Histórico
| Release | Mudanças |
|---|---|
| 17 R5 | Adicionado |
.folders( { options : Integer } ) : Collection
| Parâmetro | Tipo | Descrição | |
|---|---|---|---|
| options | Integer | -> | Opções da lista de pasta |
| Resultados | Collection | <- | Coleção de objetos de pasta filho |
|
Descrição
A função .folders() devolve uma colecção dos objetos Folder contidos na pasta pai.
Como padrão, se omitir o parâmetro options, só se devolvem as pastas no primeiro nível da pasta. Pode modificar isso passando, no parâmetro options, uma ou várias das constantes abaixo:
| Parâmetros | Valor | Comentário |
|---|---|---|
fk recursive | 1 | A coleção contém pastas da pasta especificada e suas subpastas |
fk ignore invisible | 8 | Pastas invisíveis não estão listados |
Valor retornado
Coleção de objetos Folder.
Exemplo
Se quiser a coleção de todas as pastas e subpastas da pasta database:
var $allFolders : Collection
$allFolders:=Folder("/PACKAGE").folders(fk recursive)
.getIcon()
Histórico
| Release | Mudanças |
|---|---|
| 17 R5 | Adicionado |
.getIcon( { size : Integer } ) : Picture
| Parâmetro | Tipo | Descrição | |
|---|---|---|---|
| size | Integer | -> | Longitude de lado da imagem devolvida (píxeles) |
| Resultados | Imagem | <- | Ícone |
|
Descrição
A função .getIcon() devolve o ícone da pasta.
O parâmetro opcional size especifica as dimensões em píxels do icone devolvido. Este valor representa em realidade a longitude do lado do quadrado que contém o icone. Icones são geralmente definidos como 32x32 píxels ('icones grandes') ou 16x16 ('icones pequenos'). Se passar 0 ou omitir este parâmetro, se devolve a versão 'icone grande'
Se a pasta não existir no disco, se devolve um icone vazio como padrão.
Valor retornado
Imagen do icone da pasta.