4D Doc Center : PV SAVE DOCUMENT

4D View v14

PV SAVE DOCUMENT


PV SAVE DOCUMENT ( area ; documento ; modelo ; substituir ; formato )

Parâmetro	Tipo	Descrição
area	Inteiro longo	4D View area
documento	cadeia	Nome do documento
modelo	Inteiro	0 = Documento; 1 = Modelo
substituir	Inteiro	0 = Não substituir; 1 = Substituir
formato	Inteiro longo	Formato do documento

Descrição

O comando PV SAVE DOCUMENT guarda a area 4D View como um documento em disco.

Passe em documento o nome e a via de acesso completa do documento a guardar. Se passar uma cadeia vazia neste parâmetro, aparecerá uma caixa de diálogo padrão de guardar arquivos e o usuário poderá selecionar o nome e a via do documento. Se o usuário faz clique no botão Cancelar, o documento não se guarda.

O parâmetro modelo permite estabelecer se o documento deve ser guardado como um documento padrão (modelo = 0) ou como um modelo (modelo = 1). Para mais informação sobre os modelos, consulte a descrição do comando PV OPEN DOCUMENT.

Se existe um documento com o mesmo nome na área indicada, PV SAVE DOCUMENT pode sobrescrever o arquivo existente em função do valor do parâmetro substituir. Neste caso, se substituir vale 0, se devolve o erro # 26: "Este documento já existe." Se o nome foi criado pelo usuário (cadeia vazia em documento), o sistema operativo mostrará a confirmação tradicional "Este documento já existe", independentemente do valor de substituir.

Se o documento destino é utilizado por outra área 4D View, PV SAVE DOCUMENT devolve um erro se tratado de um modelo ou não.

Utilize as constantes do tema PV Formato documento para definir o parâmetro formato, que permite configurar o formato em que deseja guardar o documento:

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

Exemplo

Depois de abrir um documento externo com o comando PV OPEN DOCUMENT, instalamos um método de chamada de retorno detectando a mudança de célula ativa.

 C_BOOLEAN(FlagModifiedArea)

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

O código do método projeto EventMethod é o seguinte:

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

 C_LONGINT($2) `Tipo de evento

 C_LONGINT($3) `Código da tecla de modificação

 C_LONGINT($4) `Número da coluna

 C_LONGINT($5) `Número da linha

 C_LONGINT($6) `Código Ascii da tecla

 C_BOOLEAN($0) `Valor a devolver

 

 $0:=False

 FlagModifiedArea:=True `Área modificada

Se o documento se modificou, o usuário logo pode guardar o documento modificado e colocar o nome que deseje:

 If(FlagModifiedArea) `Documento modificado?

    CONFIRM("Quer guardar este documento como um modelo?";"Template";"Document")

  `Este será um modelo se o diálogo se confirma OK=1)

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

 End if

Variáveis e conjuntos do sistema

A variável sistema OK toma o valor 1 se o documento foi guardado corretamente.