Usina BRAdvPL Guia
Entrar
← Todos os tópicos
CLASSEEm revisão

MSMGet

MsmGet():New([cAlias],[uPar2],nOpc,lUnqFocus,[uPar5],[uPar6],[aAcho],[aPos],[aCpos],[nModelo],[uPar11],[uPar12],[uPar13],[oWnd],[lF3],[lMemoria],[lColumn],[caTela],[lNoFolder],[lProperty],[aField],[aFolder],[lCreate],[lNoMDIStretch],[uPar25])

Cria um formulário de campos a partir do SX3 ou de um array.

MSMGetAdvPL
01 · VISÃO GERAL

Visão geral

MsMGet organiza controles e validações de campos. Pode editar variáveis de memória ou campos da tabela conforme lMemoria. lProperty evita depender de aTela/aGets Private e usa as propriedades correspondentes. A validação segue X3_VLDUSER, X3_VALID e depois o gatilho. nOpc é a posição em aRotina quando esse Private existe; não confundir posição com código da operação. A página oficial diverge na quarta posição: a sintaxe atual usa lUnqFocus, mas a tabela antiga ainda cita uPar4; confirmar a LIB, pois lUnqFocus é documentado a partir de 20220502. (Fontes: refs. 1–1.)

02 · SINTAXE

Sintaxe

MsmGet():New([cAlias],[uPar2],nOpc,lUnqFocus,[uPar5],[uPar6],[aAcho],[aPos],[aCpos],[nModelo],[uPar11],[uPar12],[uPar13],[oWnd],[lF3],[lMemoria],[lColumn],[caTela],[lNoFolder],[lProperty],[aField],[aFolder],[lCreate],[lNoMDIStretch],[uPar25])

Parâmetros

nOpc
NuméricoObrigatório

Posição em aRotina ou operação conforme contexto.

lUnqFocus
LógicoObrigatório

Foco no único campo; confirmar LIB 20220502 ou posterior.

Métodos

NewCria a instância com contexto e parâmetros compatíveis.MsmGet():New([cAlias],[uPar2],nOpc,lUnqFocus,[uPar5],[uPar6],[aAcho],[aPos],[aCpos],[nModelo],[uPar11],[uPar12],[uPar13],[oWnd],[lF3],[lMemoria],[lColumn],[caTela],[lNoFolder],[lProperty],[aField],[aFolder],[lCreate],[lNoMDIStretch],[uPar25])
RefreshAtualiza os controles.oForm:Refresh()
EnableHabilita edição.oForm:Enable()
DisableDesabilita edição.oForm:Disable()
ShowExibe os controles.oForm:Show()
HideOculta os controles.oForm:Hide()
SetFocusAtribui foco.oForm:SetFocus()

Retorno

New cria o objeto; a documentação não fornece retornos úteis para os métodos listados.

03 · EXEMPLO PRÁTICO

Exemplo comentado

#Include "Protheus.ch"

User Function Ed548()
    // Requer objeto ja construido; bloco nao invocado.
    Local bAtualizar := {|oForm| oForm:Refresh()}
    ConOut(ValType(bAtualizar))
Return Nil
Resultado esperado

Imprime B; não cria formulário nem grava campos. Em revisão: exemplo editorial não compilado nem executado em Protheus. Conferir includes, release, RDD e contexto antes de homologar.

BOAS PRÁTICAS
  • Os opcionais completos estão na fonte; não copiar a assinatura histórica para LIB atual sem conferir posições. Limitar campos editáveis, preparar contêiner e contexto e separar refresh de persistência. MV_ENCHOLD influencia MsMGet, não MVC.
  • 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. MsMGet. TDN. 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