COMANDOEn revisión

ACTIVATE DIALOG

ACTIVATE DIALOG <oDlg> [CENTERED]

Activa un diálogo tras definirlo y prepararlo.

ACTIVATE DIALOGAdvPL

01 · DESCRIPCIÓN GENERAL

Descripción general

Definir diálogo crea estructura; ACTIVATE DIALOG inicia interacción. TDialog documenta ventana modal que impide entrada en otras ventanas mientras está activa. CENTERED aparece en ejemplos oficiales y centra diálogo. Tratar validación de cierre y resultado explícitamente; llegar al código posterior no significa confirmar grabación. (TOTVS, s.f., ref. 1)

02 · SINTAXIS

Sintaxis

ACTIVATE DIALOG <oDlg> [CENTERED]

Parámetros

oDlg

ObjetoObligatorio

Objeto diálogo ya definido.

Retorno

Comando de activación; aplicación debe controlar resultado de negocio.

03 · EJEMPLO PRÁCTICO

Ejemplo comentado

#Include "TOTVS.ch"

User Function EdDialog()
    Local oDlg
    // Preparar ventana antes de iniciar interaccion modal.
    DEFINE DIALOG oDlg TITLE "Consulta de prueba" FROM 0, 0 TO 160, 300 PIXEL
    ACTIVATE DIALOG oDlg CENTERED
    // Cerrar ventana no confirma una grabacion.
Return Nil

Resultado esperado

Propone ventana vacía de prueba cerrada por control estándar de ventana. En revisión: ejemplo editorial no compilado ni ejecutado en Protheus. Comprobar includes, release, RDD y contexto antes de probar.

BUENAS PRÁCTICAS

Ejecutar en sesión interactiva. No abrir diálogos en jobs ni REST; prever validación y limpieza al cerrar.
En revisión: ejemplo editorial no compilado ni ejecutado en Protheus. Comprobar includes, release, RDD y contexto antes de probar.

Contenido relacionado

REFERENCIAS

TOTVS. Classe TDialog. TOTVSTEC/TDN. Consulta el 2026-10-25.

Estado: En revisión
Página creada el: 25/10/2026 a las 12:08
Última revisión el: 25/10/2026 a las 12:08
Idioma original: Portugués
Revisión: Usina.BR