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

MSGetDados

MsGetDados():New(nTop,nLeft,nBottom,nRight,nOpc,[cLinhaOk],[cTudoOk],[cIniCpos],[lDeleta],[aAlter],[nFreeze],[lEmpty],[nMax],[cFieldOk],[cSuperDel],[uPar],[cDelOk],[oWnd],[lUseFreeze],[cTela])

Mantém um grid legado baseado em aHeader e aCols.

MSGetDadosAdvPL
01 · VISÃO GERAL

Visão geral

A TOTVS declara MsGetDados depreciada e recomenda MVC Protheus para novos desenvolvimentos. O grid usa Private aRotina, aHeader, aCols e lRefresh. aCols segue os campos do cabeçalho e acrescenta uma coluna lógica de exclusão. Propriedades documentadas incluem aAlter (campos editáveis), nMax (limite de linhas) e lDeleta (habilita exclusão). A sintaxe abaixo lista o construtor; o catálogo de métodos desta página é um recorte para manutenção, não a API completa. (Fontes: refs. 1–1.)

02 · SINTAXE

Sintaxe

MsGetDados():New(nTop,nLeft,nBottom,nRight,nOpc,[cLinhaOk],[cTudoOk],[cIniCpos],[lDeleta],[aAlter],[nFreeze],[lEmpty],[nMax],[cFieldOk],[cSuperDel],[uPar],[cDelOk],[oWnd],[lUseFreeze],[cTela])

Parâmetros

nTop
NuméricoObrigatório

Limite superior.

nLeft
NuméricoObrigatório

Limite esquerdo.

nBottom
NuméricoObrigatório

Limite inferior.

nRight
NuméricoObrigatório

Limite direito.

nOpc
NuméricoObrigatório

Posição da ação em aRotina.

Métodos

NewConstrutor: exige contexto Private e contêiner preparados.MsGetDados():New(nTop,nLeft,nBottom,nRight,nOpc,[cLinhaOk],[cTudoOk],[cIniCpos],[lDeleta],[aAlter],[nFreeze],[lEmpty],[nMax],[cFieldOk],[cSuperDel],[uPar],[cDelOk],[oWnd],[lUseFreeze],[cTela])
Retorno

Objeto da classe.

EnableHabilita interação.oGrid:Enable()
DisableDesabilita interação.oGrid:Disable()
ForceRefreshAtualiza a fonte de dados e posiciona na primeira linha.oGrid:ForceRefresh()

Retorno

New retorna o objeto; retornos dos demais métodos não são usados no exemplo.

03 · EXEMPLO PRÁTICO

Exemplo comentado

#Include "Protheus.ch"

User Function Ed541()
    // Exige objeto ja construido no dialogo correto; bloco nao invocado.
    Local bAtualizar := {|oGrid| oGrid:ForceRefresh()}
    ConOut(ValType(bAtualizar))
Return Nil
Resultado esperado

Imprime B. Ao invocar com objeto válido, o refresh pode mudar a linha corrente. Em revisão: exemplo editorial não compilado nem executado em Protheus. Conferir includes, release, RDD e contexto antes de homologar.

BOAS PRÁTICAS
  • Conferir assinatura e todos os opcionais na fonte antes de construir. Restaurar áreas e liberar recursos em erros. Refresh não grava dados; preservar escolha do usuário e validar linhas antes de persistir.
  • 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. MsGetDados. 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