4D Doc Center : PV EXPORT

4D View v14

PV EXPORT


PV EXPORT ( area ; doc ; remplazar ; formato )

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

Descripción

El comando PV EXPORT exporta el area 4D View, o en el área de exportación, como documento del disco.

En documento, pase el nombre y la ruta de acceso completa del documento a exportar. Si pasa una cadena vacía en este parámetro, aparece una caja de diálogo de exportación de archivos y el usuario puede especificar el nombre y la ubicación del documento. En este caso, si el usuario hace clic en el botón Cancelar, el documento no se exporta.

Si un documento con el mismo nombre existe en el lugar indicado, PV EXPORT sobrescribe o no el archivo de acuerdo con el valor del parámetro remplazar. En este caso, cuando remplazar es 0, no hay error. Error 26: "El documento ya existe". Si el nombre fue definido por el usuario (cadena vacía en el documento), es el sistema operativo que muestra la confirmación tradicional "Este documento ya existe...", cualquiera que sea el valor del parámetro remplazar.

Utilice las constantes del tema PV Formato documento para definir el parámetro formato, permitiendo especificar el formato de registro del documento:

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

Nota: la constante de formato de documento pv view no se puede aplicar a este comando.

A diferencia del comando PV SAVE DOCUMENT (que guarda la totalidad de un área), el comando PV EXPORT permite registrar sólo el área de exportación del documento. El área de exportación puede ser definida manualmente por el usuario (Archivo/Área de exportación>Definir), o por programación con la instrucción PV EXECUTE(area; pv cmd export area set). El área de exportación se compone de las celdas seleccionadas en el momento de la definición del área. Por defecto, el área de exportación se compone de la totalidad del documento.

Ejemplo

El siguiente ejemplo permite exportar al formato HTML el conjunto de las celdas seleccionadas en un área. Si ninguna celda está seleccionada al momento de la exportación, se define un rango arbitrario:

 ARRAY LONGINT($ALleft;0) `Números de columna de las celdas de la izquierda

 ARRAY LONGINT($ALtop;0) `Números de línea de las celdas de arriba

 ARRAY LONGINT($ALright;0) `Números de columna de las celdas de la derecha

 ARRAY LONGINT($ALbottom;0) `Números de línea de las celdas de abajo

 

 PV GET SELECTED RANGES LIST(area;$ALleft;$ALtop;$ALright;$ALbottom)

 

 If(Size of array($ALleft)=0) `Ninguna celda está seleccionada

    PV SELECT RANGE(area;2;4;5;7;pv selection set) `Rango arbitrario

 Else

    PV SELECT RANGES LIST(area;$ALleft;$ALtop;$ALright;$ALbottom;pv selection set)

 End if

 

  `Reducimos el área de exportación al rango seleccionado

 PV EXECUTE COMMAND(area;pv cmd export area set)

 PV EXPORT(area;"";1;pv html)

 

  `To initialize export area for the whole document

 PV EXECUTE COMMAND(area;pv cmd export area clear)