Subpágina de progreso (acción)
La acción Subpágina de progreso (imagen siguiente) se usa (i) para indicar la subpágina en la que se verá el progreso de las acciones del servidor, y (ii) para definir como acciones secundarias las acciones del servidor que se quieren ejecutar (para las que es necesario un indicador del progreso).
Propiedades de la subpágina
•La lista desplegable de la acción contiene las subpáginas del proyecto. Seleccione la subpágina que quiere usar para mostrar el progreso de las acciones del servidor. En la imagen siguiente se ha seleccionado la tabla Progress. También puede introducir una expresión XPath que se resuelva en el nombre de la subpágina de destino. Esto es útil si quiere seleccionar la subpágina de forma dinámica (es decir, si la selección depende de la ejecución).
•XML de origen: especifica si lo datos de la subpágina corresponden a fuentes de página de la página de partida. Esta definición se introduce en el cuadro de diálogo "Asignación de datos de la subpágina". Este cuadro de diálogo se abre haciendo clic en el botón Examinar del campo XML de origen. Para consultar una descripción más detallada de este cuadro de diálogo, véase la sección XML de origen de las subpáginas.
•Mensaje de carga de la subpágina: en caso de que la subpágina se transmita a través de una solicitud de servidor, si marca esta casilla podrá definir qué mensaje aparece mientras se carga la subpágina (imagen anterior).
•Mensaje de cierre de la subpágina: en caso de que la subpágina se transmita a través de una solicitud de servidor, si marca esta casilla podrá definir qué mensaje aparece mientras se cierra la subpágina (imagen anterior).
•Mostrar subpágina como cuadro de diálogo modal: si no marca esta casilla, la subpágina se superpondrá a la página de nivel superior (el usuario puede volver a la página de nivel superior pulsando el botón Atrás). Si, por el contrario, marca esta casilla, la subpágina se abrirá en una nueva ventana por encima de la página de nivel superior (llamado cuadro de diálogo modal). En este caso, la posibilidad de volver a la página de nivel superior desde el cuadro de diálogo modal queda deshabilitada. Si el usuario toca fuera de la ventana modal, se ejecutan las acciones especificadas para el evento de página AlHacerClicEnBotónAtrás. Si no hay una acción especificada para este evento, la subpágina se cerrará y la ejecución volverá a la página de nivel superior.
Definir cuadros de diálogo modales
Las siguientes definiciones se pueden aplicar a cuadros de diálogo modales:
•Puede establecer las dimensiones de la ventana de diálogo modal con las expresiones XPath de las propiedades Ancho y Alto.
•Si no se especifica nada en la propiedad opcional Alto, la altura será la mínima necesaria para abarcar el contenido, con la altura de la ventana de visualización del dispositivo como tope máximo. Si se necesita una altura mayor, se añade automáticamente una barra de desplazamiento al cuadro de diálogo modal.
•Puede añadir los valores de las dimensiones en forma de número (dimensiones en píxeles) o con una cadena que contenga un valor numeral y un símbolo % (para especificar las dimensiones del cuadro de diálogo como un porcentaje de las dimensiones de la ventana de visualización).
•En la imagen anterior estas dimensiones se han configurado con los valores de ancho y alto específicos del dispositivo (dimensiones del área de visualización), que se obtienen del dispositivo de forma dinámica en tiempo de ejecución.
•Puede escoger entre: (i) usar la misma configuración de dimensiones para las orientaciones vertical y horizontal del cuadro de diálogo modal o (ii) usar unas dimensiones específicas para cada orientación (es decir, unas dimensiones para la orientación vertical y otras distintas para la orientación horizontal).
•Si se establece que el cuadro de diálogo modal tenga las mismas dimensiones para ambas orientaciones, el alto y el ancho se toman de la orientación vertical de la página que estuviera activa antes de ejecutar la acción Ir a la subpágina. Si se selecciona esta opción, el cuadro de diálogo modal tendrá el mismo conjunto de valores para el alto y el ancho en ambas orientaciones. Esto consigue el efecto de que el cuadro de diálogo modal no cambie de tamaño al cambiar la orientación.
•Desde una subpágina mostrada como cuadro de diálogo modal puede ir a otra subpágina, que también puede abrir como cuadro de diálogo modal sobre el cuadro de diálogo modal anterior.
•Las dimensiones relativas (valores porcentuales) de todos los cuadros de diálogo modales (incluso aunque tengan origen en otros cuadros de diálogo modales) se calculan en relación a las dimensiones de la ventana de visualización del dispositivo.
•Si se abre una subpágina desde un cuadro de diálogo modal sin que se seleccione la opción de diálogo modal, la nueva subpágina tendrá las mismas dimensiones que el cuadro de diálogo modal y se superpondrá a este. Parecerá que la nueva subpágina ha reemplazado a la anterior.
Acciones del servidor
Un indicador del progreso suministra información sobre el progreso de un conjunto de acciones específico. Este conjunto está compuesto por las acciones secundarias de la acción Subpágina de progreso. Para ver un ejemplo consulte el uso de la acción Subpágina de progreso en el tutorial Indicador del progreso.