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

DEFINE DIALOG

DEFINE DIALOG oDlg TITLE cTitle FROM nTop,nLeft TO nBottom,nRight PIXEL

Define um diálogo antes de ativar a interface.

DEFINE DIALOGAdvPL
01 · VISÃO GERAL

Visão geral

DEFINE DIALOG prepara a janela; ACTIVATE DIALOG inicia sua interação. O exemplo oficial de TTimer mostra essa separação e o uso de coordenadas em pixels. A ficha TDialog descreve comportamento modal e recomenda MsDialog para aplicações Protheus. A sintaxe abaixo é um subconjunto didático observado nos exemplos, não uma lista completa de cláusulas de todos os includes. O exemplo autoral cria uma janela vazia que pode ser fechada pelo controle da janela, sem ler ou gravar dados. (TOTVS, s.d., refs. 1–2)

02 · SINTAXE

Sintaxe

DEFINE DIALOG oDlg TITLE cTitle FROM nTop,nLeft TO nBottom,nRight PIXEL

Parâmetros

oDlg
ObjetoObrigatório

Variável que recebe o diálogo.

cTitle
CaractereObrigatório

Título da janela.

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

Coordenadas inicial e final; PIXEL define a unidade.

Retorno

Comando; não possui retorno de função.

03 · EXEMPLO PRÁTICO

Exemplo comentado

#Include "Protheus.ch"
User Function Ed347()
    Local oDialogo
    // Definir primeiro; ativar somente quando a montagem estiver pronta.
    DEFINE DIALOG oDialogo TITLE "Exemplo editorial" FROM 0,0 TO 180,320 PIXEL
    ACTIVATE DIALOG oDialogo CENTERED
Return Nil
Resultado esperado

Janela vazia centralizada; nenhuma operação de banco. 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 include, ciclo de vida e compatibilidade do SmartClient.
  • 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. TDialog. TDN. Consulta em 2026-10-26.
  2. TOTVS. TTimer. TDN. Consulta em 2026-10-26.
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