Directory Class

.creationDate

Histórico

Versão	Mudanças
v17 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

Versão	Mudanças
v17 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

Versão	Mudanças
v17 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

Versão	Mudanças
v17 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

Versão	Mudanças
v17 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

Versão	Mudanças
v17 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

Versão	Mudanças
v17 R5	Adicionado

.isAlias : Boolean

Descrição

A propriedade .isAlias devolve sempre false para um objecto Folder.

Essa propriedade é apenas leitura.

---

.isFile

Histórico

Versão	Mudanças
v17 R5	Adicionado

.isFile : Boolean

Descrição

A propriedade .isFile devolve sempre false para uma pasta.

Essa propriedade é apenas leitura.

---

.isFolder

Histórico

Versão	Mudanças
v17 R5	Adicionado

.isFolder : Boolean

Descrição

A propriedade .isFolder devolve sempretrue para uma pasta.

Essa propriedade é apenas leitura.

---

.isPackage

Histórico

Versão	Mudanças
v17 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

Versão	Mudanças
v17 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

Versão	Mudanças
v17 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

Versão	Mudanças
v17 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

Versão	Mudanças
v17 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

Versão	Mudanças
v17 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

Versão	Mudanças
v17 R5	Adicionado

.path : Text

Descrição

A propriedade .path devolve o caminho POSIX da pasta. .

Essa propriedade é apenas leitura.

---

.platformPath

Histórico

Versão	Mudanças
v17 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

Versão	Mudanças
v17 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

Versão	Mudanças
v17 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

Versão	Mudanças
v17 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

Versão	Mudanças
v17 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

Versão	Mudanças
v17 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

Versão	Mudanças
v17 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.