Directory Class
.creationDate
História
| Release | Mudanças |
|---|---|
| 17 R5 | Adicionado |
.creationDate : Date
Descrição
A propriedade .creationDate retorna a data de criação da pasta.
Essa propriedade é somente leitura.
.creationTime
História
| Release | Mudanças |
|---|---|
| 17 R5 | Adicionado |
.creationTime : Time
Descrição
A propriedade .creationTime retorna o horário de criação da pasta (expresso como um número de segundos a partir de 00:00).
Essa propriedade é somente leitura.
.exists
História
| Release | Mudanças |
|---|---|
| 17 R5 | Adicionado |
.exists : Boolean
Descrição
A propriedade .exists retorna true se a pasta existe no disco e false caso contrário.
Essa propriedade é somente leitura.
.extension
História
| Release | Mudanças |
|---|---|
| 17 R5 | Adicionado |
.extension : Text
Descrição
A propriedade .extension retorna 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 é somente leitura.
.fullName
História
| Release | Mudanças |
|---|---|
| 17 R5 | Adicionado |
.fullName : Text
Descrição
A propriedade .fullName retorna o nome completo da pasta, incluindo sua extensão (se houver).
Essa propriedade é somente leitura.
.hidden
História
| Release | Mudanças |
|---|---|
| 17 R5 | Adicionado |
.hidden : Boolean
Descrição
A propriedade .hidden retorna true se o arquivo estiver definido como "hidden" no nível do sistema, e false caso contrário.
Essa propriedade é somente leitura.
.isAlias
História
| Release | Mudanças |
|---|---|
| 17 R5 | Adicionado |
.isAlias : Boolean
Descrição
A propriedade .isAlias retorna sempre false para um objeto Folder.
Essa propriedade é somente leitura.
.isFile
História
| Release | Mudanças |
|---|---|
| 17 R5 | Adicionado |
.isFile : Boolean
Descrição
A propriedade .isFile retorna sempre false para uma pasta.
Essa propriedade é somente leitura.
.isFolder
História
| Release | Mudanças |
|---|---|
| 17 R5 | Adicionado |
.isFolder : Boolean
Descrição
A propriedade .isFolder retorna sempre true para uma pasta.
Essa propriedade é somente leitura.
.isPackage
História
| Release | Mudanças |
|---|---|
| 17 R5 | Adicionado |
.isPackage : Boolean
Descrição
A propriedade .isPackage retorna true se a pasta é um pacote no macOS (e existe no disco). .
Em Windows, .isPackage sempre devolve false.
Essa propriedade é somente leitura.
.modificationDate
História
| Release | Mudanças |
|---|---|
| 17 R5 | Adicionado |
.modificationDate : Date
Descrição
A propriedade .modificationDate retorna a data da última modificação da pasta.
Essa propriedade é somente leitura.
.modificationTime
História
| Release | Mudanças |
|---|---|
| 17 R5 | Adicionado |
.modificationTime : Time
Descrição
A propriedade .modificationTime retorna a hora da última modificação da pasta (expressa como um número de segundos a partir de 00:00).
Essa propriedade é somente leitura.
.name
História
| Release | Mudanças |
|---|---|
| 17 R5 | Adicionado |
.name : Text
Descrição
A propriedade .name retorna o nome da pasta, sem extensão (se houver).
Essa propriedade é somente leitura.
.original
História
| Release | Mudanças |
|---|---|
| 17 R5 | Adicionado |
.original : 4D.Folder
Descrição
A propriedade .original retorna o mesmo objeto Pasta da pasta.
Essa propriedade é somente leitura.
Esta propriedade está disponible nas pastas para permitir que o código genérico processe pastas ou arquivos.
.parent
História
| Release | Mudanças |
|---|---|
| 17 R5 | Adicionado |
.parent : 4D.Folder
Descrição
A propriedade .parent retorna o objeto pasta pai da pasta. .
Se a pasta não tiver um pai (raiz), é devolvido o valor nulo.
Essa propriedade é somente leitura.
.path
História
| Release | Mudanças |
|---|---|
| 17 R5 | Adicionado |
.path : Text
Descrição
A propriedade .path retorna o caminho POSIX da pasta. .
Essa propriedade é somente leitura.
.platformPath
História
| Release | Mudanças |
|---|---|
| 17 R5 | Adicionado |
.platformPath : Text
Descrição
A propriedade .platformPath retorna o caminho da pasta expresso com a sintaxe da plataforma atual.
Essa propriedade é somente leitura.
.copyTo()
História
| 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 objeto Folder para a destinationFolder especificada.
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 Imagens 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ória
| 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 caminho inválido) |
Descrição
A função .file() cria um objeto File dentro do objeto Folder e retorna 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 for inválido.
Exemplo
var $myPDF : 4D. File
$myPDF:=Folder(fk documents folder).file("Pictures/info.pdf")
.files()
História
| 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() retorna uma coleção de objetos 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
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ória
| 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 path for inválida*) |
Descrição
A função .folder() cria um objeto Folder dentro do objeto Folder pai e retorna 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 for inválido.
Exemplo
var $mypicts : 4D. Folder
$mypicts:=Folder(fk documents folder).folder("Pictures")
.folders()
História
| 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() retorna uma coleção de objetos Folder contidos na pasta principal.
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ória
| 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() retorna 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
Imagem do ícone da pasta.