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

MSGET()

@ nLinha,nColuna MSGET variavel SIZE nLargura,nAltura OF oDlg PIXEL

Cria um campo de entrada vinculado a variável.

MSGET()AdvPL
01 · VISÃO GERAL

Visão geral

MSGET é um comando de criação de campo vinculado a variável, dentro de um diálogo. SIZE e PIXEL definem dimensões; OF indica o contêiner. VALID valida conteúdo e WHEN controla edição; PICTURE formata a entrada, sem garantir regra de negócio. A sintaxe usa uma variável editável, não uma constante. (Fontes: refs. 1–1.)

02 · SINTAXE

Sintaxe

@ nLinha,nColuna MSGET variavel SIZE nLargura,nAltura OF oDlg PIXEL

Parâmetros

variavel
VariávelObrigatório

Variável vinculada ao campo.

coordenadas / SIZE
NuméricoObrigatório

Posição e dimensões na unidade escolhida.

Retorno

Comando de interface; não há retorno de função documentado nesta sintaxe.

03 · EXEMPLO PRÁTICO

Exemplo comentado

#Include "Protheus.ch"

User Function Ed540()
    Local oDlg
    Local cValor := Space(20)
    // Interface SmartClient: fechar a janela para encerrar.
    DEFINE MSDIALOG oDlg TITLE "Exemplo" FROM 0,0 TO 100,300 PIXEL
    @ 12,12 MSGET cValor SIZE 100,12 OF oDlg PIXEL
    ACTIVATE MSDIALOG oDlg CENTERED
Return Nil
Resultado esperado

Abre uma janela; fechar não grava dados automaticamente. Em revisão: exemplo editorial não compilado nem executado em Protheus. Conferir includes, release, RDD e contexto antes de homologar.

BOAS PRÁTICAS
  • Exigir sessão com interface e validar layout no cliente usado. Separar confirmação, cancelamento e gravação; não usar diálogo modal em job sem interface.
  • 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. MSGET(). 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