Sintaxe

FwGetArea()


Propósito

Salva o ambiente ativo.


Argumentos

Nenhum.


Utilização

Essa função é utilizada para proteger e preservar o ambiente ativo quando houver a necessidade de algum processamento específico.

Para salvar outra área de trabalho (alias), que não a ativa, a função FwGetArea() deve ser executada dentro do alias. Por exemplo: SA1->(FwGetArea()).

A função retorna um array contendo as seguintes variáveis do ambiente:


  • Alias()
  • IndexOrd()
  • Recno()


Exemplos

Suponhamos que o ambiente ativo seja do alias SA1, índice 1 e registro 345. Vejamos o exemplo abaixo:

Local aAreaAnt := FwGetArea()

dbSelectArea(“SC5”)
dbSetOrder(2)

…

<instruções do processamento>

…

FwRestArea(aAreaAnt)   // Retorna o ambiente anterior

Return Nil



As funções GetArea e FwGetArea possuem a mesma funcionalidade, sendo recomendável priorizar o uso da FwGetArea por se tratar de uma função pertencente a Lib.

  • Sem rótulos