Open document

versión 11 (Modificado)

Open document (documento{; elTipo{; modo}}) DocRef

El comando Open document abre el documento cuyo nombre o ruta de acceso se pasa en documento.

Si pasa una cadena vacía en document, aparece una caja de diálogo estándar de apertura de archivos, y el usuario puede seleccionar el documento a abrir. Si cancela el diálogo, no se abre el documento; Open document devuelve una referencia de documento nula, y la variable OK toma el valor 0.

• Si el documento se abre correctamente, Open document devuelve su número de referencia y la variable OK toma el valor 1.

• Si el documento está abierto y se omite el parámetro modo, Open document abre el documento en modo lectura y la variable OK toma el valor 1.

• Si el documento ya está abierto y usted trata de abrirlo en modo escritura, se genera un error.

• Si el documento no existe, se genera un error.

En el parámetro elTipo, pase el o los tipo(s) de archivo(s) que pueden ser seleccionados en la caja de diálogo de apertura. Puede pasar una lista de varios tipos separados por un ; (punto y coma). Para cada tipo definido, se añadirá una línea en el menú de elección del tipo de caja de diálogo.

Bajo Mac OS, puede pasar el tipo Mac OS clásico (TEXT, APPL, etc.), o un tipo UTI (Uniform Tipo Identifier). Los tipos UTIs son definidos por Apple para responder a las necesidades de estandarización de los tipos de archivos. Por ejemplo, "public.text" es el tipo UTI de los archivos de tipo texto. Para mayor información sobre los UTIs, consulte la siguiente dirección: http://developer.apple.com/documentation/Carbon/Conceptual/understanding_utis/index.html.

Bajo Windows, también puede pasar un tipo de archivo clásico Mac OS — 4D efectúa la correspondencia interna — o la extensión de los archivos (.txt, .exe, etc.). Note que bajo Windows, el usuario puede "forzar" la visualización de todos los tipos de archivos introduciendo *.* en la caja de diálogo. Sin embargo, en este caso, 4D llevará a cabo una verificación adicional de los tipos de archivos seleccionados: si el usuario selecciona un tipo de archivo no autorizado, el comando devuelve un error.

Si no quiere restringir los archivos mostrados a uno o varios tipos, pase la cadena "*" (asterisco) o ".*" en elTipo.

El parámetro opcional modo permite definir el modo de apertura del archivo documento. Están disponibles cuatro modos de apertura. 4D ofrece las siguientes constantes predefinidas, ubicadas en el tema "System Documents":

Cuando un documento está abierto, Open document se ubica inicialmente al comienzo del documento, mientras Append document se ubica al final del documento.

Una vez haya abierto un documento, puede leer y escribir en el documento utilizando los comandos RECEIVE PACKET y SEND PACKET que puede combinar con los comandos Get document position y SET DOCUMENT POSITION para acceder directamente a cualquier parte del documento.

No olvide llamar finalmente a CLOSE DOCUMENT para el documento.

1. El siguiente ejemplo abre un documento existente llamado Nota, escribe la cadena "Hasta luego", y cierra el documento. Si el documento contiene la cadena "Hola", esta cadena se remplazará:

   C_TIME(vhDoc) 
   vhDoc:=Open document ("Nota.txt";Read and Write)   `Abrir el documento Nota
   If (OK=1) 
      SEND PACKET (vhDoc"Hasta luego")   ` Escribe una palabra en el documento
      CLOSE DOCUMENT (vhDoc)  ` Cierra el documento 
   End if

2. Ahora puede leer un documento incluso si está abierto en modo escritura:

   vDoc:=Open document ("PassFile";"TEXT") ` El archivo está abierto
      ` Antes de cerrar el archivo, es posible consultarlo en modo de solo lectura:
   vRef:=Open document ("PassFile";"TEXT";Read Mode) ` El archivo está cerrado

Si el documento se abre correctamente, la variable sistema OK toma el valor 1; de lo contrario, toma el valor 0. Después de la llamada, la variable sistema Document contiene el nombre completo del documento.

Si pasa el valor 3 en modo, la función devuelve ?00:00:00? (sin referencia de documento). El documento no se abre pero las variables sistema Document y OK se actualizan:

• OK toma el valor 1.

• Document contiene la ruta de acceso y el nombre del archivo document.

Nota: Si el archivo definido en document no se encuentra o si pasa una cadena vacía en documento, aparece una caja de diálogo de apertura de archivos. Si el usuario elije un documento y hace clic en el botón OK, documento define la ruta al documento seleccionado por el usuario y OK toma el valor 1. Si el usuario hace clic en el botón Cancelar, OK toma el valor 0.

Append document, Create document.