4D Doc Center : Utilizar as áreas 4D Write

4D Write v14

Utilizar as áreas 4D Write

Há três tipos de áreas disponíveis em 4D:

Áreas 4D Write incluídas nos formulários
Janelas externas 4D Write
Áreas 4D Write fora da tela.

Para utilizar um documento 4D Write, pode criar uma área de plug-in em um formulário ou abrir uma janela externa. Pode criar uma área externa, desenhando a área em um formulário no entorno Desenho. Uma janela externa é aberta, seja pela eleição de 4D Write no menu Ferramentas ou mediante a execução do comando Open external window.

Além da criação de áreas visíveis, pode criar áreas invisíveis fora do monitor. Para obter mais informação, consulte o parágrafo "Áreas Fora da tela 4D Write", mais a frente nesta seção.

Número de Identificação e variável da área 4D Write

4D Write utiliza variáveis para armazenar a localização das áreas 4D Write, janelas externas e áreas fora da tela. Para referenciar a área na que deseja realizar uma operação, deve passar a variável que contém o número de identificação da área como parâmetro para o comando ou a função.
Nas descrições de comandos desta documentação, o parâmetro área se refere a variável de identificação da área do documento.

Há dois tipos de variável area:

Nomes dos objetos externos
Quando cria e dá nome a uma área 4D Write, 4D reconhece automaticamente o nome da área 4D Write como uma variável que faz referencia a área. Por exemplo, você se referiria à área Carta especificando "Carta", como parâmetro área.
As variáveis que você cria para uma janela externa ou uma área fora da tela
Quando cria uma janela externa ou uma área fora da tela utilizando as funções Open external window ou WR New offscreen area, pode guardar o número de ID de área devolvido pela função em uma variável. A continuação, você pode utilizar a variável para fazer referencia a janela externa ou a área fora da tela em outros comandos e funções. Para guardar o valor em uma variável, localize o nome da variável e o operador de atribuição (:=) a esquerda da função na linha de código..

A maioria de comandos 4D Write requerem que se especifique uma área antes de que possam ser executados.

Áreas de plug-in 4D Write

Quando deseje que um documento 4D Write apareça em um formulário 4D, deve criar uma área plug-in no formulário e lhe atribuir um nome único, especificando o tipo de plug-in como 4D Write.

4D permite salvar este documento com o registro.
Provavelmente você utiliza com mais frequência a área do plug-in para armazenar um documento ou para usá-lo no lugar de um campo de texto se o formato é importante.

Janelas externas 4D Write

4D lhe permite criar um documento 4D Write em uma área independente chamada uma janela externa. As janelas externas são úteis quando deseja que o usuário tenha acesso a um processador de textos em qualquer momento para escrever cartas, memorandos e outros documentos.

Executando a função 4D, Open external window, desde um método abre uma janela especificada e devolve um ID de área em uma variável inteiro longo. Pode fazer referência a esta variável cada vez que deseje executar um comando 4D Write para afetar a janela externa.

Por exemplo:

vWrite:=Open external window(50;50;350;450;8;"Merge Letter";"_4D Write")

Para obter mais informação sobre o comando Open external window, consulte sua definição no Manual de linguagem 4D.

Áreas 4D Write fora da tela

Uma área fora da tela se armazena na memória e não é visível para o programador ou para o usuário. Pode utilizar uma área fora da tela para modificar um documento antes que um usuário o veja ou para guardar o documento para que o usuário possa voltar ao original, se é necessário.

WR New offscreen area e WR PICTURE TO AREA são os dois comandos que se utilizam para criar uma área fora da tela. Lembre que deve eliminar a área fora da tela depois de ter terminado de utilizar para liberar a memória que utiliza.

Quando se põe em um método global, o seguinte código cria uma área fora da tela para guardar o documento.

 QUERY([Empregados];[Empregados]ID=vID)

 If(Records in selection([Empregados]=1)

    Area:=WR New offscreen area

    WR PICTURE TO AREA(Area;[Empregados]Review_)

  `Guardar review na área fora da tela

    MODIFY RECORD([Empregados])

  `Modificar o registro empregados

    WR DELETE OFFSCREEN AREA(Area)

  `Liberar a memória utilizada pela área fora de tela

 End if

Utilizando um botão em um formulário, pode permitir ao usuário voltar ao documento original guardado.

Pode criar um botão no formulário de entrada e lhe atribui o seguinte código:

 Review:=WR Area to picture(Area)

  `Põe a área fora da tela que contém o documento original na área externa

  `contida no formulário Review.