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

ACTIVATE DIALOG

ACTIVATE DIALOG <oDlg> [CENTERED]

Ativa um diálogo depois de sua definição e montagem.

ACTIVATE DIALOGAdvPL
01 · VISÃO GERAL

Visão geral

Definir o diálogo cria sua estrutura; ACTIVATE DIALOG inicia sua interação. A documentação TDialog descreve uma janela modal: enquanto ativa, impede entrada nas demais janelas. CENTERED aparece nos exemplos oficiais e centraliza o diálogo. A validação de encerramento e o resultado da interação devem ser tratados explicitamente; simplesmente chegar ao código após ACTIVATE não significa que o usuário confirmou uma gravação. (TOTVS, s.d., ref. 1)

02 · SINTAXE

Sintaxe

ACTIVATE DIALOG <oDlg> [CENTERED]

Parâmetros

oDlg
ObjetoObrigatório

Objeto de diálogo já definido.

Retorno

Comando de ativação; o resultado de negócio deve ser controlado pela aplicação.

03 · EXEMPLO PRÁTICO

Exemplo comentado

#Include "TOTVS.ch"

User Function EdDialog()
    Local oDlg
    // Monta a janela antes de iniciar o processamento modal.
    DEFINE DIALOG oDlg TITLE "Consulta de teste" FROM 0, 0 TO 160, 300 PIXEL
    ACTIVATE DIALOG oDlg CENTERED
    // Fechar a janela nao confirma nenhuma gravacao.
Return Nil
Resultado esperado

Propõe uma janela vazia de teste, encerrada pelo controle padrão da janela. Em revisão: exemplo editorial não compilado nem executado em Protheus. Conferir includes, release, RDD e contexto antes de homologar.

BOAS PRÁTICAS
  • Executar em sessão com interface. Não abrir diálogo em job ou REST; prever validação e limpeza de objetos no fechamento.
  • 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. Classe TDialog. TOTVSTEC/TDN. Consulta em 2026-10-25.
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