4D Doc Center : PV EXPORT

4D View v14

PV EXPORT


PV EXPORT ( area ; documento ; substituir ; formato )

Parâmetro	Tipo	Descrição
area	Inteiro longo	Área 4D View
documento	cadeia	Nome do documento ou cadeia vazia
substituir	Inteiro	0 = Não substituir; 1 = Substituir
formato	Inteiro longo	Formato do documento

Descrição

O comando PV EXPORT exporta a area 4D View, ou na área de exportação, como documento do disco.

Em documento, passe o nome e a via de acesso completa do documento a exportar. Se passar uma cadeia vazia neste parâmetro, aparece uma caixa de diálogo de exportação de arquivos e o usuário pode especificar o nome e a localização do documento. Neste caso, se o usuário faz clique no botão Cancelar, o documento não se exporta.

Se um documento com o mesmo nome existe no lugar indicado, PV EXPORT sobrescrito ou não o arquivo de acordo com o valor do parâmetro substituir. Neste caso, quando substituir é 0, não há erro. Erro 26: "O documento já existe". Se o nome foi definido pelo usuário (cadeia vazia no documento), é o sistema operativo que mostra a confirmação tradicional "Este documento já existe...", qualquer que seja o valor do parâmetro substituir.

Utilize as constantes do tema PV Formato documento para definir o parâmetro formato, permitindo especificar o formato de registro do documento:

Constante	Tipo	Valor
pv html	Inteiro longo	3
pv sylk	Inteiro longo	2
pv tab tab return	Inteiro longo	1

Nota: A constante de formato de documento pv view não pode ser aplicado a este comando.

A diferença do comando PV SAVE DOCUMENT (que guarda a totalidade de uma área), o comando PV EXPORT permite registrar só a área de exportação do documento. A área de exportação pode ser definida manualmente pelo usuário (Arquivo/Área de exportação>Definir), ou por programação com a instrução PV EXECUTE(area; pv cmd export area set). A área de exportação se compõe das células selecionadas no momento da definição da área. Por padrão, a área de exportação se compõe da totalidade do documento.

Exemplo

O seguinte exemplo permite exportar ao formato HTML o conjunto das células selecionadas em uma área. Se nenhuma célula está selecionada ao momento da exportação, se define uma faixa arbitrária:

 ARRAY LONGINT($ALleft;0) `Números de coluna das células da esquerda

 ARRAY LONGINT($ALtop;0) `Números de linha das células de cima

 ARRAY LONGINT($ALright;0) `Números de coluna das células da direita

 ARRAY LONGINT($ALbottom;0) `Números de linha das células de baixo

 

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

 

 If(Size of array($ALleft)=0) `Nenhuma célula está selecionada

    PV SELECT RANGE(area;2;4;5;7;pv selection set) `Faixa arbitrária

 Else

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

 End if

 

  `Reduzimos a área de exportação a faixa selecionado

 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)