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

MBrowse em cadastros legados

MBrowse( nTop, nLeft, nBottom, nRight, cAlias, ... )

Entenda o browse tradicional e sua integração com SX3 e aRotina.

MBrowse em cadastros legadosAdvPL
01 · VISÃO GERAL

Visão geral

MBrowse apresenta registros de um alias com apoio do dicionário SX3. A documentação exige aRotina definida como Private antes da chamada; cada opção informa título, função, reservado e operação. Operações 1 a 6 representam pesquisar, visualizar, incluir, alterar, excluir e especial. Ao informar uma função sem parênteses, o framework encaminha alias, registro e opção. Em tabelas de trabalho, consultar os requisitos de TRB e aFixe. Aqui o exemplo limita o menu a pesquisa e visualização para não sugerir CRUD sem implementação. (Ref. 1)

02 · SINTAXE

Sintaxe

MBrowse( nTop, nLeft, nBottom, nRight, cAlias, ... )

Parâmetros

nTop, nLeft, nBottom, nRight
NuméricoObrigatório

Coordenadas inicial e final do browse; assinatura resumida, demais argumentos na referência.

cAlias
CaractereObrigatório

Alias aberto com dicionário compatível.

Retorno

A ficha consultada não estabelece um contrato de retorno para uso por aplicações.

03 · EXEMPLO PRÁTICO

Exemplo comentado

#Include "Protheus.ch"

User Function EdMBrow()
    Local aArea := GetArea()
    Private cCadastro := "Consulta de clientes"
    Private aRotina := {;
        {"Pesquisar", "AxPesqui", 0, 1},;
        {"Visualizar", "AxVisual", 0, 2};
    }
    // Exige ambiente Protheus e SA1 aberta com dicionario valido.
    If Select("SA1") > 0
        DbSelectArea("SA1")
        MBrowse(6, 1, 22, 75, "SA1")
    EndIf
    RestArea(aArea)
Return Nil
Resultado esperado

Com SA1 disponível, propõe uma consulta com duas opções; sem o alias, não abre o browse. O Return Nil pertence à função editorial, não documenta retorno de MBrowse. 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 usar menu reduzido como autorização de acesso. Validar permissões, campos visíveis e filtros de filial; considerar FWMBrowse em novos projetos, sem substituição automática de contratos.
  • 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. MBROWSE. TDN. Consulta em 2026-10-24.
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