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

The .hidden property returns true if the folder is set as "hidden" at the system level, and false otherwise.

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.

The destinationFolder must exist on disk, otherwise an error is generated.

Como padrão, a pasta é copiada com o nome da pasta original. If you want to rename the copy, pass the new name in the newName parameter. 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.

If a folder with the same name already exists in the destinationFolder, by default 4D generates an error. You can pass the fk overwrite constant in the overwrite parameter to ignore and overwrite the existing file

Parâmetros	Valor	Comentário
fk overwrite	4	Sobrescrever os elementos existentes, se houver

Valor retornado

O objeto Folder copiado.

Exemplo

You want to copy a Pictures folder from the user's Document folder to the Database folder:

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.

In path, pass a relative POSIX path to designate the file to return. 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.

By default, if you omit the options parameter, only the files at the first level of the folder are returned in the collection, as well as invisible files or folders. You can modify this by passing, in the options parameter, one or more of the following constants:

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.

By default, if you omit the options parameter, only the folders at the first level of the folder are returned in the collection. You can modify this by passing, in the options parameter, one or more of the following constants:

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 .

The optional size parameter specifies the dimensions in pixels of the returned icon. 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.