4D v14.3

Open document

Página Inicial

 
4D v14.3
Open document

Open document 


 

Open document ( documento {; tipoArquivo}{; modo} ) -> Resultado 
Parâmetro Tipo   Descrição
documento  cadeia in Nome de documento ou rota de acesso completa ou string vazia para caixa de diálogo de arquivo
tipoArquivo  cadeia in Lista de tipos de documentos a serem pesquisados, ou "*" para não pesquisar os documentos
modo  Inteiro longo in Modo de abertura do documento
Resultado  DocRef in Número de referência de documento

O comando Open document abre o documento cujo nome ou rota de acesso se passa em documento.

Se passar uma string vazia em documento, aparece uma caixa de diálogo padrão de abertura de arquivos, e o usuário pode selecionar o documento a abrir. Se cancelar o diálogo,  o documento não é aberto; Open document retorna uma referência de documento nula, e a variável OK toma o valor 0.

  •  Se o documento abrir corretamente,  Open document retorna seu número de referência e a variável OK toma o valor 1.
  •  Se o documento estiver aberto e o parâmetro modo for omitido,  Open document abre o documento em modo leitura/escritura e a variável OK toma o valor 1.
  •  Se o documento já estiver aberto em modo leitura/escritura e você tentar abri-lo em modo escrita, um erro é gerado (-43) No entanto pode abri-lo em modo leitura unicamente, logo a variável OK toma o valor 1.
  •  Se o documento não existir, um erro é gerado.

No parâmetro tipoArquivo, passe os tipos de arquivos que podem ser selecionados na caixa de diálogo de abertura. Pode passar uma lista de vários tipos separados por um ";" (ponto e vírgula). Para cada tipo definido, uma linha nserá adicionada ao menu para escolher o tipo de caixa de diálogo.

Em Mac OS, pode passar o tipo Mac OS clásico (TEXT, APPL, etc.), ou um tipo UTI (Uniform Tipo Identifier). Os tipos UTIs são definidos por Apple para responder  as necessidades de padronização dos tipos de arquivos. Por exemplo, "public.text" é o tipo UTI dos arquivos de tipo texto. Para maior informação sobre os UTIs, consulte a seguinte direção:
https://developer.apple.com/library/mac/#documentation/FileManagement/Conceptual/
understanding_utis/understand_utis_intro/understand_utis_intro.html
.

Em Windows, também pode passar um tipo de arquivo clássico Mac OS, 4D realiza a correspondência interna, ou a extensão dos arquivos (.txt, .exe, etc.). Note que em Windows, o usuário pode “forçar” a visualização de todos os tipos de arquivos introduzindo *.* na caixa de diálogo. Entretanto, neste caso, 4D realizará uma verificação adicional dos tipos de arquivos selecionados: se o usuário selecionar um tipo de arquivo não autorizado, o comando retorna um erro.

Se não deseja restringir os arquivos mostrados a um ou mais tipos, passe a cadeia "*" (asterisco) ou ".*" em tipoArquivo.

O parâmetro opcional modo permite definir o modo de abertura do arquivo documento. Estão disponíveis quatro diferentes modos de abertura. 4D oferece as seguintes constantes pré-definidas, localizadas no tema  "Documentos Sistema":

Constante Tipo Valor
Get Pathname Inteiro longo 3
Read and Write Inteiro longo 0
Read Mode Inteiro longo 2
Write Mode Inteiro longo 1
Quando um documento for aberto, Open document se localiza inicialmente ao começo do documento, enquanto Append document é localizado ao final do documento.

Quando abrir um documento, pode ler e escrever no documento utilizando os comandos RECEIVE PACKET e SEND PACKET que pode combinar com os comandos Get document position e SET DOCUMENT POSITION para acessar diretamente a qualquer parte do documento.

Não esqueça de, no final, chamar CLOSE DOCUMENT para o documento.

O exemplo abaixo abre um documento existente chamado Nota, escreve a string “Até logo”, e fecha o documento. Se o documento contiver a string “Olá”, esta string será substituida:

 C_TIME(vhDoc)
 vhDoc:=Open document("Nota.txt";Read and Write`Abrir o documento Nota
 If(OK=1)
    SEND PACKET(vhDoc"Até logo") ` Escreve uma palavra no documento
    CLOSE DOCUMENT(vhDoc) ` Fecha o documento
 End if

Agora pode ler um documento mesmo se estiver aberto em modo escrita:

 vDoc:=Open document("PassFile";"TEXT") ` O arquivo está aberto
  ` Antes de fechar o arquivo, é possível consultá-lo em modo apenas leitura:
 vRef:=Open document("PassFile";"TEXT";Read Mode` O arquivo está fechado

Se o documento for aberto corretamente, a variável sistema OK assume o valor 1; do contrário, assume o valor 0. Depois da chamada, a variável sistema Document contém o nome completo do documento.

Se passa o valor 3 em modo, a função retorna ?00:00:00? (sem referência de documento). O documento não é aberto mas as variáveis sistema Document e OK são atualizadas:

  •    OK toma o valor 1.
  •    Document contém a rota de acesso e o nome do arquivo document.



Nota: se não for encontrado o arquivo definido em documento ou se for passado uma string vazia em documento, aparece uma caixa de diálogo de abertura de arquivos. Se o usuário escolher um documento e clicar no botão OK, documento define a rota ao documento selecionado pelo usuário e OK toma o valor 1. Se o usuário clicar no botão Cancelar, OK toma o valor 0.

 
PROPRIEDADES 

Produto: 4D
Tema: Documentos de Sistema
Número 264

Este comando modifica a variável sistema OKEste comando modifica a variável sistema DocumentEste comando modifica a variável sistema Error

 
HISTÓRIA 

Modificado: 4D v11 SQL

 
VER TAMBÉM 

Append document
Create document

 
ARTICLE USAGE

Manual de linguagem 4D ( 4D v11 SQL Release 6)
Manual de linguagem 4D ( 4D v12.4)
Manual de linguagem 4D ( 4D v14 R3)
Manual de linguagem 4D ( 4D v14 R2)
Manual de linguagem 4D ( 4D v13.5)
Manual de linguagem 4D ( 4D v14.3)
Manual de linguagem 4D ( 4D v14 R4)