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

MSGetDB

MsGetDB():New(nTop,nLeft,nBottom,nRight,nOpc,[cLinhaOk],[cTudoOk],[cIniCpos],[lDelete],[aAlter],[nFreeze],[lEmpty],[uPar1],cTRB,[cFieldOk],[uPar2],[lAppend],[oWnd],[lDisparos],[uPar3],[cDelOk],[cSuperDel])

Mantém um grid legado baseado em tabela temporária.

MSGetDBAdvPL
01 · VISÃO GERAL

Visão geral

Classe legada que edita linhas em alias temporário, indicado por cTRB no construtor. Exige Private aRotina e aHeader; a tabela deve seguir o cabeçalho e conter o indicador lógico de exclusão final. Enable e Disable controlam a interação; ForceRefresh atualiza e posiciona na primeira linha. Os callbacks de validação devem ser funções acessíveis, não Static. O trecho cobre somente esses três métodos e não cria a tabela ou o diálogo. (Fontes: refs. 1–1.)

02 · SINTAXE

Sintaxe

MsGetDB():New(nTop,nLeft,nBottom,nRight,nOpc,[cLinhaOk],[cTudoOk],[cIniCpos],[lDelete],[aAlter],[nFreeze],[lEmpty],[uPar1],cTRB,[cFieldOk],[uPar2],[lAppend],[oWnd],[lDisparos],[uPar3],[cDelOk],[cSuperDel])

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.

cTRB
CaractereObrigatório

Alias temporário da edição.

Métodos

NewConstrutor: exige contexto Private e contêiner preparados.MsGetDB():New(nTop,nLeft,nBottom,nRight,nOpc,[cLinhaOk],[cTudoOk],[cIniCpos],[lDelete],[aAlter],[nFreeze],[lEmpty],[uPar1],cTRB,[cFieldOk],[uPar2],[lAppend],[oWnd],[lDisparos],[uPar3],[cDelOk],[cSuperDel])
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 Ed542()
    // 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. MsGetDB. 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