Document Class

Descrição

.creationDate

Histórico

Versão	Mudanças
v17 R5	Adicionado

.creationDate : Date

Descrição

A propriedade .aceita a transação devolve A propriedade .modificationDate devolve.

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 do arquivo (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 o ficheiro existir em 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 do ficheiro (se existir). Uma extensão sempre começa com ".". Uma extensão sempre começa com "." A propriedade devolve uma string vazia se o nome do arquivo 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 do ficheiro, 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 o arquivo for definido como "escondido" ao nível do sistemae false de outra forma.

Esta propriedade é read/write.

.isAlias

Histórico

Versão	Mudanças
v17 R5	Adicionado

.isAlias : Boolean

Descrição

A propriedade .isAlias devolve verdadeiro se o arquivo for um alias (apelido), um atalho, ou um link simbólicoe false de outra forma.

Essa propriedade é apenas leitura.

.isFile

Histórico

Versão	Mudanças
v17 R5	Adicionado

.isFile : Boolean

Descrição

A propriedade .isFile devolve A função .copyTo().

Essa propriedade é apenas leitura.

.isFolder

Histórico

Versão	Mudanças
v17 R5	Adicionado

.isFolder : Boolean

Descrição

A propriedade .isFolder devolve A propriedade .platformPath devolve.

Essa propriedade é apenas leitura.

.isWritable

Histórico

Versão	Mudanças
v17 R5	Adicionado

.isWritable : Boolean

Descrição

A propriedade .isWritable devolve verdadeiro se o arquivo existir em disco e for gravável.

A propriedade verifica a habilidade da aplicação 4D de escrever no disco (direitos de acesso), não depende apenas do atributo writable do arquivo.

Essa propriedade é apenas leitura.

Exemplo

 $myFile:=File("C:\\Documents\\Archives\\ReadMe.txt";fk platform path)
 If($myFile.isWritable)
    $myNewFile:=$myFile.setText("Added text")
 End if

.modificationDate

Histórico

Versão	Mudanças
v17 R5	Adicionado

.modificationDate : Date

Descrição

A propriedade .modificationDate devolve A propriedade .aceita a transação devolve.

Essa propriedade é apenas leitura.

.modificationTime

Histórico

Versão	Mudanças
v17 R5	Adicionado

.modificationTime : Time

Descrição

A propriedade .modificationTime devolve A propriedade .modificationTime devolve (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 A propriedade .isFile devolve.

Essa propriedade é apenas leitura.

.original

Histórico

Versão	Mudanças
v17 R5	Adicionado

|

Descrição

A propriedade .original devolve o elemento alvo de um alias, um atalho, ou um arquivo de ligação simbólica. O elemento alvo pode ser:

• um objeto File
• um objeto folder

Para arquivos não-alias, a propriedade retorna o mesmo objeto de arquivo que o arquivo.

Essa propriedade é apenas leitura.

.parent

Histórico

Versão	Mudanças
v17 R5	Adicionado

.parent : 4D. Folder

Descrição

A propriedade .parent devolve A propriedade .parent devolve. .

Essa propriedade é apenas leitura.

.path

Histórico

Versão	Mudanças
v17 R5	Adicionado

.path : Text

Descrição

A propriedade .path devolve A propriedade .path devolve. .

Essa propriedade é apenas leitura.

.platformPath

Histórico

Versão	Mudanças
v17 R5	Adicionado

.platformPath : Text

Descrição

A propriedade .platformPath devolve o caminho do ficheiro expresso com a sintaxe da plataforma actual.

Essa propriedade é apenas leitura.

.size

Histórico

Versão	Mudanças
v17 R5	Adicionado

.size : Real

Descrição

A propriedade .size devolve o tamanho do arquivo expresso em bytes. Se o arquivo não existir em disco, o tamanho é 0.

Essa propriedade é apenas leitura.

.copyTo()

Histórico

Versão	Mudanças
v17 R5	Adicionado

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

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. File	<-	Arquivo copiado

|

Descrição

A função .copyTo() A propriedade .isFolder devolve .

A destinationFolder deve existir em disco, senão um erro é gerado.

Como padrão, o arquivo é copiado com o nome do arquivo 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 um arquivo 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 File copiado.

Exemplo

Se quiser copiar um arquivo Imagem da pasta de documentos do usuário a pasta da aplicação:

var $source; $copy : Object
$source:=Folder(fk documents folder).file("Pictures/photo.png")
$copy:=$source.copyTo(Folder("/PACKAGE");fk overwrite)

.getContent()

Histórico

Versão	Mudanças
v17 R5	Adicionado

.getContent( ) : Blob

Parâmetro	Tipo		Descrição
Resultados	Blob	<-	Conteúdo do arquivo

|

Descrição

A função .getContent() retorna um BLOB contendo todo o conteúdo de um arquivo. Para informações sobre BLOBs, consultar a secção BLOB .

Valor retornado

Um Blob.

Exemplo

Para salvar o conteúdo de um documento em um campo BLOB:

 var $vPath : Text
 $vPath:=Select document(""; "*"; "Select a document";0)
 If(OK=1) //Se tiver sido escolhido um documento
    [aTable]aBlobField:=File($vPath;fk platform path).getContent()
 End if

.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 do ficheiro.

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 o arquivo não existir no disco, um ícone em branco padrão será retornado.

Valor retornado

Ícone de arquivo imagem.

.getText()

Histórico

Versão	Mudanças
v17 R5	Adicionado

.getText( { charSetName : Text { ; breakMode : Integer } } ) : Text
.getText( { charSetNum : Integer { ; breakMode : Integer } } ) : Text

Parâmetro	Tipo		Descrição
charSetName	Text	->	Nome do conjunto de caracteres
charSetNum	Integer	->	Número de conjuntos de caracteres
breakMode	Integer	->	Modo de processamento para quebras de linha
Resultados	Text	<-	Texto do documento

|

Descrição

A função .getText() devolve o conteúdo do ficheiro como texto .

Opcionalmente, você pode designar o conjunto de caracteres a ser usado na leitura do conteúdo. Você pode passar também:

• em charSetName, uma string que contém o nome padrão definido (por exemplo "ISO-8859-1" ou "UTF-8"),
• ou em charSetNum, o MIBEnum ID (número) do nome de configuração padrão.

Para a lista de conjuntos de caracteres suportados por 4D, consulte a descrição do comando CONVERT FROM TEXT.

Se o documento contiver uma nota de ordem de byte (BOM), 4D usa o conjunto de caracteres que definiu em vez do especificado no charSetName ou charSetNum (este parâmetro é então ignorado). Se o documento não contiver uma LDM e se o charSetName ou charSetNum for omitido, por padrão 4D usa o conjunto de caracteres "UTF-8".

Em breakMode, você pode passar um número indicando o processamento a aplicar aos caracteres de fim de linha no documento. As seguintes constantes do tema "Documentos do Sistema" estão disponíveis:

Parâmetros	Valor	Comentário
Document unchanged	0	Não processado
Document with native format	1	(Padrão) As quebras de linha são convertidas para o formato nativo do sistema operacional: CR (retorno de carro) sob OS X, CRLF (retorno do carro + salto de linha) em Windows
Documento com CRLF	2	Quebras de linha são convertidas em formato Windows: CRLF (retorno de carro + quebra de linha)
Documento com CR	3	Quebras de linha são convertidas para o formato OS X: CR (retorno de carro)
Documento com LF	4	Quebras de linha são convertidas em formato Unix: LF (feed de linha)

Por padrão, ao omitir o parâmetro breakMode , as quebras de linha são processadas no modo nativo (1).

Valor retornado

Texto do arquivo.

Exemplo

Dado o seguinte documento de texto (os campos são separados por tabulações):

id name price vat
3 thé 1.06€ 19.6
2 café 1.05€ 19.6

Quando você executar este código:

 $myFile:=Folder(fk documents folder).file("Billing.txt") //UTF-8 por padrão
 $txt:=$myFile.getText()

|

"id\tname\tprice\tvat\r\n3\tthé\t1.06€\t19.6\r\n2\tcafé\t1.05€\t19.6"

com \t (tab) como separador e \r\n (CRLF) como delimitador de linha.

Aqui está outro exemplo com o mesmo arquivo, mas um delimitador de linha diferente:

 $txt:=$myFile.getText("UTF-8"; Document with LF)

Neste caso, o conteúdo de $txt é o seguinte:

"id\tname\tprice\tvat\n3\tthé\t1.06€\t19.6\n2\tcafé\t1.05€\t19.6"

Este tempo \n (LF) é usado como delimitador de linha.