Usina BRAdvPL Guia
Entrar
← Todos os tópicos
FUNçãOEm revisão

RESTAREA()

RestArea(aArea)

Restaura alias, ordem e posição salvos por GetArea.

RESTAREA()AdvPL
01 · VISÃO GERAL

Visão geral

RestArea recebe o array produzido por GetArea e restaura alias, IndexOrd e Recno. A última área restaurada fica ativa. Isso não reabre automaticamente uma área fechada nem restaura qualquer estado imaginável, como transações, ambiente da empresa ou filtros não incluídos nesse contrato. Quando alterar uma segunda área, salve o contexto dela também e restaure a área original por último. A variante FWGetArea/FWRestArea deve ser avaliada conforme o framework do release. (Fontes: refs. 1–2.)

02 · SINTAXE

Sintaxe

RestArea(aArea)

Parâmetros

aArea
ArrayObrigatório

Snapshot produzido por GetArea, sem mudança de estrutura.

Retorno

Não usado; a referência selecionada não especifica retorno útil.

03 · EXEMPLO PRÁTICO

Exemplo comentado

#Include "Protheus.ch"

User Function Ed620()
    // Bloco nao invocado: exige ao menos uma area aberta e preservada.
    Local bRestaurar := {|aArea| RestArea(aArea)}
    ConOut(ValType(bRestaurar))
Return Nil
Resultado esperado

Cria bloco B sem inventar um snapshot de área. Em revisão: exemplo editorial não compilado nem executado em Protheus. Conferir includes, release, RDD e contexto antes de homologar.

BOAS PRÁTICAS
  • Não feche aliases do chamador. Planeje restauração também quando ocorrer erro.
  • Em revisão: exemplo editorial não compilado nem executado em Protheus. Conferir includes, release, RDD e contexto antes de homologar.

Conteúdos relacionados

REFERÊNCIAS
  1. TOTVS. RestArea. TDN. Consulta em 2026-10-27.
  2. Atilio. dan-atilio/AdvPL. Maratona de Exemplos/Exemplo_220_Funcoes_FWGetArea_FWRestArea_GetArea_e_RestArea.prw. Arquivo completo consultado; adaptação editorial. Consulta em 2026-10-27.
Situação
Em revisão
Página criada em
Última revisão em
Idioma original
Português
Revisão
Usina.BR
0 comentário(s) aprovado(s)

Comentários

Ainda não há comentários aprovados.

Entre com Google ou Microsoft para comentar.

Powered by Usina Docs · Alpha