Usina BRAdvPL Guia
Entrar
← Todos os tópicos
PONTO DE ENTRADAEm revisão

F241BTN

ExecBlock("F241BTN", .F., .F., aBut240)

Coleção recebida em FINA241: análise do chamador e diagnóstico editorial do contexto.

F241BTNFINA241
01 · VISÃO GERAL

Visão geral

A listagem oficial registra ExecBlock com aBut240 como quarto argumento. (TOTVS, s.d., ref. 2) A Academia ProERP publica uma análise intitulada Protheus 12.1.2210 que situa a chamada em FA241BORDE e atribui o retorno a aBut240; o Universo do Desenvolvedor também exibe esse trecho. (Academia ProERP, s.d., ref. 3; Universo do Desenvolvedor, s.d., ref. 4) Essa leitura orienta o diagnóstico abaixo, mas não documenta a estrutura de cada botão. A página específica permanece em construção no índice. A Academia foi consultada por evidência indexada; não houve inspeção do fonte padrão completo nem execução em Protheus.

02 · SINTAXE

Sintaxe

ExecBlock("F241BTN", .F., .F., aBut240)

Parâmetros

PARAMIXB / aBut240
Qualquer (verificar no release)Contexto a confirmar

Pela regra geral de ExecBlock, o quarto argumento fica disponível diretamente em PARAMIXB. A chamada registrada passa aBut240, sem envolvê-lo em outro array. (TOTVS, s.d., refs. 2 e 5) O diagnóstico verifica o tipo efetivo antes de contar elementos; ele não presume que PARAMIXB[1] contenha toda a coleção.

Retorno

No trecho comunitário, o retorno de ExecBlock substitui aBut240. Isso sugere a devolução da coleção ao chamador; é uma interpretação do trecho, não um contrato oficial completo. O exemplo editorial devolve o conteúdo recebido sem modificá-lo.

03 · EXEMPLO PRÁTICO

Diagnóstico editorial que preserva o conteúdo recebido

#Include "Protheus.ch"

User Function F241BTN()
    // Exemplo editorial baseado na chamada publicada; não é código da Academia.
    // O contexto chega diretamente por PARAMIXB, sem presumir posições de botão.
    Local uBotoes := PARAMIXB

    ConOut("F241BTN: tipo recebido = " + ValType(uBotoes))
    // Conta apenas após confirmar que o conteúdo recebido é um array.
    If ValType(uBotoes) == "A"
        ConOut("F241BTN: quantidade de elementos = " + AllTrim(Str(Len(uBotoes))))
    EndIf

    // Preserva o valor recebido; este exemplo não adiciona botões.
Return uBotoes
Resultado esperado

Se PARAMIXB for array, escreve seu tipo e quantidade de elementos no console; para outros tipos, escreve somente o tipo. Retorna o mesmo conteúdo recebido. Resultado previsto pela leitura do código; não compilado nem executado no Protheus.

04 · EXEMPLO PRÁTICO

Trecho do chamador publicado pela comunidade

// Recorte documental atribuído à Academia ProERP e ao Universo do Desenvolvedor.
// O restante de FA241BORDE não está reproduzido.
aBut240 := ExecBlock("F241BTN", .F., .F., aBut240)
Resultado esperado

O trecho atribui o retorno a aBut240. Não é uma implementação de F241BTN nem pode ser executado isoladamente.

BOAS PRÁTICAS
  • A finalidade de manipular a coleção é inferida do chamador; formato das linhas de botão, ações e permissões continuam a confirmar.
  • Confirme esse ponto no release-alvo antes de acrescentar ou alterar botões. O título 12.1.2210 da análise não comprova outros releases.
  • O diagnóstico registra apenas tipo e quantidade; não imprime títulos, valores nem conteúdo dos elementos.
  • Momento da transação, aliases, bloqueios e estrutura interna da coleção não foram confirmados.

Conteúdos relacionados

REFERÊNCIAS
  1. TOTVS. Pontos de Entrada - Financeiro - P12. TDN. Evidência indexada consultada em 2026-10-22.
  2. TOTVS. Pontos de Entrada. TDN. Evidência indexada consultada em 2026-10-22.
  3. Academia ProERP. Pontos de Entrada do TOTVS Protheus 12.1.2210 P.2/3. Consulta em 2026-10-22.
  4. Universo do Desenvolvedor. Pontos de Entrada P12.2210 - Parte 2. Consulta em 2026-10-22.
  5. TOTVS. ExecBlock - Execução do ponto de entrada. TDN. Consulta em 2026-10-22.
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