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

FORMBATCH()

FormBatch( cTitulo, aTexto, aBotoes, [bValid], [nAltura], [nLargura] )

Apresenta mensagens e ações em uma janela legada.

FORMBATCH()AdvPL
01 · VISÃO GERAL

Visão geral

FormBatch recebe título, linhas de texto e botões no formato tipo/habilitado/bloco. A documentação descreve retorno numérico da opção; o exemplo público também controla sua escolha por variável no callback, sem usar o retorno da função. Comentários de limite de linhas/botões daquele fonte não foram promovidos a contrato geral. A adaptação tem uma linha e um botão de cancelamento que chama FechaBatch; não lê arquivos nem inicia importação. Sua disponibilidade exige contexto de interface Protheus. (TOTVS, s.d., ref. 1)

02 · SINTAXE

Sintaxe

FormBatch( cTitulo, aTexto, aBotoes, [bValid], [nAltura], [nLargura] )

Parâmetros

cTitulo
CaractereObrigatório

Título da janela.

aTexto
ArrayObrigatório

Linhas de mensagem.

aBotoes
ArrayObrigatório

Tipo, habilitação e bloco por botão.

bValid
Bloco de códigoOpcional

Validação da janela.

nAltura
NuméricoOpcional

Altura em pixels.

nLargura
NuméricoOpcional

Largura em pixels.

Retorno

A ficha descreve número da opção; o exemplo não utiliza esse retorno.

03 · EXEMPLO PRÁTICO

Exemplo comentado

#Include "Protheus.ch"

User Function Ed389()
    Local aTexto := {"Demonstracao sem processamento"}
    Local aBotoes := {{2, .T., {|| FechaBatch()}}}
    // Apenas interface: o callback encerra a janela.
    FormBatch("Exemplo editorial", aTexto, aBotoes)
Return Nil
Resultado esperado

Janela com mensagem e cancelamento, sem processamento de negócio. Em revisão: exemplo editorial não compilado nem executado em Protheus. Conferir includes, release, RDD e contexto antes de homologar.

BOAS PRÁTICAS
  • Confirmar callbacks e encerramento no release; não tratar escolha visual como confirmação de gravação.
  • 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. FORMBATCH(). TDN. Consulta em 2026-10-26.
  2. EURAI. ADVPL/Funcoes/Mensagens/FORMBATCH.PRW. universo_do_desenvolvedor_site, commit a5c83e9490302bdb4a0fc5a9d92c2d569a60773c. Exemplo analisado. Consulta em 2026-10-26.
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