Saltar para o conteúdo principal
Versão: 20

Directory Class

.creationDate

Histórico
ReleaseMudanças
17 R5Adicionado

.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
ReleaseMudanças
17 R5Adicionado

.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
ReleaseMudanças
17 R5Adicionado

.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
ReleaseMudanças
17 R5Adicionado

.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
ReleaseMudanças
17 R5Adicionado

.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
ReleaseMudanças
17 R5Adicionado

.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
ReleaseMudanças
17 R5Adicionado

.isAlias : Boolean

Descrição

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

Essa propriedade é apenas leitura.


.isFile

Histórico
ReleaseMudanças
17 R5Adicionado

.isFile : Boolean

Descrição

A propriedade .isFile devolve sempre false para uma pasta.

Essa propriedade é apenas leitura.


.isFolder

Histórico
ReleaseMudanças
17 R5Adicionado

.isFolder : Boolean

Descrição

A propriedade .isFolder devolve sempretrue para uma pasta.

Essa propriedade é apenas leitura.


.isPackage

Histórico
ReleaseMudanças
17 R5Adicionado

.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
ReleaseMudanças
17 R5Adicionado

.modificationDate : Date

Descrição

A propriedade .modificationDate devolve a data da última modificação da pasta.

Essa propriedade é apenas leitura.


.modificationTime

Histórico
ReleaseMudanças
17 R5Adicionado

.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
ReleaseMudanças
17 R5Adicionado

.name : Text

Descrição

A propriedade .name devolve o nome da pasta, sem extensão (se houver).

Essa propriedade é apenas leitura.


.original

Histórico
ReleaseMudanças
17 R5Adicionado

.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
ReleaseMudanças
17 R5Adicionado

.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
ReleaseMudanças
17 R5Adicionado

.path : Text

Descrição

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

Essa propriedade é apenas leitura.


.platformPath

Histórico
ReleaseMudanças
17 R5Adicionado

.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
ReleaseMudanças
17 R5Adicionado

.copyTo( destinationFolder : 4D. Folder { ; newName : Text } { ; overwrite : Integer } ) : 4D. Folder

ParâmetroTipoDescrição
destinationFolder4D. Folder->Pasta de destino
newNameText->Nome para a copia
overwriteInteger->fk overwrite para substituir os elementos existentes
Resultados4D. 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âmetrosValorComentário
fk overwrite4Sobrescrever 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
ReleaseMudanças
17 R5Adicionado

.file( path : Text ) : 4D. File

ParâmetroTipoDescrição
pathText->Rota POSIX relativa
Resultados4D. 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
ReleaseMudanças
17 R5Adicionado

.files( { options : Integer } ) : Collection

ParâmetroTipoDescrição
optionsInteger->Opções da lista de arquivos
ResultadosCollection<-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âmetrosValorComentário
fk recursive1A coleção contém arquivos da pasta especificada e suas subpastas
fk ignore invisible8Arquivos 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
ReleaseMudanças
17 R5Adicionado

.folder( path : Text ) : 4D. Folder

ParâmetroTipoDescrição
pathText->Rota POSIX relativa
Resultados4D. 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
ReleaseMudanças
17 R5Adicionado

.folders( { options : Integer } ) : Collection

ParâmetroTipoDescrição
optionsInteger->Opções da lista de pasta
ResultadosCollection<-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âmetrosValorComentário
fk recursive1A coleção contém pastas da pasta especificada e suas subpastas
fk ignore invisible8Pastas 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
ReleaseMudanças
17 R5Adicionado

.getIcon( { size : Integer } ) : Picture

ParâmetroTipoDescrição
sizeInteger->Longitude de lado da imagem devolvida (píxeles)
ResultadosImagem<-Í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.