4D v13
PV EXPORT
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 | |||||
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.
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)
Produto: 4D
Tema: PV Documento
Número
15800
Criado por: 4D View 6.8.1
