icc.ui.dialog

Representa una ventana sobre puesta dentro de la aplicación que puede contener otros controles.

Metodos

create ();

Crea los objetos necesarios en el navegador.Este metódo es ejecutado automaticamente por el sistema al cargar un formulario realizado por el diseñador.Si está creando mediante código un control para incluir al formulario en tiempo de ejecución es necesario llamar a este metodo.


object getWnd ();

Retorna el objeto html que contiene el control.


addChild ( object  newchild );
newchildAgrega un control a la colección 'childs' del diálogo o panel.Debe llamarse al método layout luego de realizadas todas las modificaciones en la coleccion 'childs'.

rmvChild ( object  child );
childObjeto a remover. El metodo compara los objetos contenidos en la colección 'childs' con el argumento y lo elimina de la misma.

Remueve un control existente en el diálogo o panel.Debe llamarse al método layout luego de realizadas todas las modificaciones en la coleccion 'childs'


rmvAll ();

Remueve todos los elementos de la colección 'childs' del diálogo o panel.


layout ();

Recalcula y reposiciona todos los controles contenidos en el diálogo o panel


showModal ( [ function callback ( variant  result ) { ... } ] );
callbackFunción invocada cuando la ejecución del diálogo modal finaliza.
resultValor de finalización del diálogo. Si el diálogo es cerrado mediante el botón estándar de cerrar la ventana o mediante un botón con acción 'close' este valor es false. Si es cerrado mediante un botón con acción 'ok' este valor es true. Puede usar también el método 'close' para cerrar el diálogo y recibir en este parámetro el valor pasado al método.

close ( [variant  result] );
resultValor de retorno de la ejecución del diálogo.
Eventos

onClose (function( variant  result ) { ... } )
resultValor de finalización del diálogo. Si el diálogo es cerrado mediante el botón estándar de cerrar la ventana o mediante un botón con acción 'close' este valor es false. Si es cerrado mediante un botón con acción 'ok' este valor es true. Puede usar también el método 'close' para cerrar el diálogo y recibir en este parámetro el valor pasado al método.

Evento invocado cuando el diálogo modal está a punto de finalizar. Retornando false en este evento impide que finalice la ejecución del diálogo.

Propiedades

array childs

Colección de controles contenidos en un diálogo o panel

Ejemplo
Creación de un diálogo mediante código.
					
var btnOk = new icc.ui.button({caption:'Ok',centerX:true,action:'ok'});
var dlg = new icc.ui.dialog({
    caption:'Atención',
    childs:[
        new icc.ui.label({caption:'Presione Ok para continuar'}),
        btnOk
    ]
})
dlg.create();
dlg.showModal(function(result){
    alert(result); // El dialogo ha finalizado
});

					

caption

Título del diálogo.

Ejemplo
Creación de un diálogo modal con el contenido de un formulario
					
// carga el formulario usando el objeto application
icc.ui.getApplication().loadForm("testdialog",function(status,form){ 
    var dlg = new icc.ui.dialog({
        childs:[
            form    // el formulario es el unico objeto dentro del díalogo
        ]
    });
    dlg.create();   // crea los objetos en el navegador
    dlg.showModal(function(result){
        alert(result)        // obtiene el resultado de la ejecución
    });
});