4D Doc Center : PV SAVE DOCUMENT

4D View v14

PV SAVE DOCUMENT


PV SAVE DOCUMENT ( area ; doc ; plantilla ; remplazar ; formato )

Parámetro	Tipo	Descripción
area	Entero largo	Área 4D View
doc	Cadena	Nombre del documento o cadena vacía
plantilla	Entero	0 = Documento; 1 = Plantilla
remplazar	Entero	0 = No remplazo; 1 = Remplazo
formato	Entero largo	Formato del documento

Descripción

El comando PV SAVE DOCUMENT guarda el area 4D View como un documento en disco.

Pase en documento el nombre y la ruta de acceso completa del documento a guardar. Si pasa una cadena vacía en este parámetro, aparecerá una caja de diálogo estándar de guardar archivos y el usuario podrá seleccionar el nombre y la ruta del documento. Si el usuario hace clic en el botón Cancelar, el documento no se guarda.

El parámetro plantilla permite establecer si el documento debe ser guardado como un documento estándar (plantilla = 0) o como una plantilla (plantilla = 1). Para más información sobre las plantillas, consulte la descripción del comando PV OPEN DOCUMENT.

Si existe un documento con el mismo nombre en el área indicada, PV SAVE DOCUMENT puede sobrescribir el archivo existente en función del valor del parámetro remplazar. En este caso, si remplazar vale 0, se devuelve el error # 26: "Este documento ya existe." Si el nombre fue creado por el usuario (cadena vacía en documento), el sistema operativo mostrará la confirmación tradicional "Este documento ya existe", independientemente del valor de remplazar.

Si el documento de destino es utilizado por otra área 4D View, PV SAVE DOCUMENT devuelve un error si se trata de una plantilla o no.

Utilice las constantes del tema PV Formato documento para definir el parámetro formato, que permite configurar el formato en que desea guardar el documento:

Constante	Tipo	Valor
pv html	Entero largo	3
pv sylk	Entero largo	2
pv tab tab return	Entero largo	1
pv view	Entero largo	0

Ejemplo

Después de abrir un documento externo con el comando PV OPEN DOCUMENT, instalamos un método de retrollamada detectando el cambio de celda activa.

 C_BOOLEAN(FlagModifiedArea)

 PV ON EVENT(Area;pv on active cell changed;"EventMethod")

El código del método proyecto EventMethod es el siguiente:

 C_LONGINT($1) `Referencia del área 4D View

 C_LONGINT($2) `Tipo de evento

 C_LONGINT($3) `Código de la tecla de modificación

 C_LONGINT($4) `Número de la columna

 C_LONGINT($5) `Número de la línea

 C_LONGINT($6) `Código Ascii de la tecla

 C_BOOLEAN($0) `Valor a devolver

 

 $0:=False

 FlagModifiedArea:=True `Área modificada

Si el documento se modificó, el usuario luego puede guardar el documento modificado y ponerle el nombre que desee:

 If(FlagModifiedArea) `¿Documento modificado?

    CONFIRM("¿Quiere guardar este documento como una plantilla?";"Template";"Document")

  `Esta será una plantilla si el diálogo se confirma OK=1)

    PV SAVE DOCUMENT(Area;"";OK;1;pv view)

 End if

Variables y conjuntos del sistema

La variable sistema OK toma el valor 1 si el documento se ha guardado correctamente.