AYUDA EN LÍNEA
 WINDEVWEBDEV Y WINDEV MOBILE

Este contenido se ha traducido automáticamente.  Haga clic aquí  para ver la versión en inglés.
Ayuda / Desarrollar una aplicación o un sitio web / Características específicas de WINDEV Mobile
  • Presentación
  • Implementación
  • Configuración de la control o de la ventana
  • " Tirar a actualización" Event
  • Personalización de la función "Tirar a actualización "
  • Barra de refresco
  • " Tirar a actualización" Event: gestión del bar
WINDEV
WindowsLinuxUniversal Windows 10 AppJavaReportes y ConsultasCódigo de Usuario (UMC)
WEBDEV
WindowsLinuxPHPWEBDEV - Código Navegador
WINDEV Mobile
AndroidWidget Android iPhone/iPadIOS WidgetApple WatchMac CatalystUniversal Windows 10 App
Otros
Procedimientos almacenados
Presentación
La función "Tirar a actualización" permite al usuario "tirar" de un control Tabla, un control Looper o una ventana para actualización su contenido.
Durante esta acción, aparece automáticamente una barra actualización en la zona "expuesta".:
  • Primero, la barra indica que se debe deslizar hacia abajo para actualizar.
  • Luego, indica que se debe soltar para actualizar.
  • También indica que la actualización está en curso. Durante la actualización se muestra una barra de progreso.
  • El control se actualiza.
Un simple gesto refresca el contenido mostrado
Un simple gesto refresca el contenido mostrado
Implementación

Configuración de la control o de la ventana

Para utilizar gesto "Pull-to-refresh":
  1. Abrir la ventana de control description (Mesa o Looper) o la ventana.
  2. En la pestaña "Destalles" de la ventana de descripción del control, seleccione la opción "Deslizar hacia abajo para actualizar (Pull to refresh)".
  3. Especifique (si es necesario) la ventana interna que se utilizará para "Tirar a actualización".. Es posible:
    • utilizar la visualización nativa de la plataforma (opción "Ninguno").
    • usar una ventana de preajuste. En este caso (opción "Ventana predefinida"), WINDEV Mobile propone importar una ventana predefinida. La ventana interna se añade inmediatamente al proyecto actual y se associated con la característica. Esta ventana se puede personalizar si es necesario.
      Observación: La ventana interna se denomina "IW_PULL_TO_REFRESH".
  4. Android Especifique (si es necesario) la Color de la barra de progreso utilizada por Default. Esta color se tiene en cuenta cuando se utiliza la visualización Default (opción "Ninguna").
  5. Validar (si es necesario) la ventana description.
La configuración de la funcionalidad "Pull-to-refresh" agregó:
  • la barra de actualización que se mostrará al usuario durante la operación. Un bar actualización es propuesto por Default. Si se ha solicitado la personalización, esta barra corresponde a una ventana interna añadida al proyecto para su personalización..
  • el "Pull to actualización" Event entre el (Table o Looper) control o ventana Event s. Esta Event se llama automáticamente durante el gesto de actualización.

" Tirar a actualización" Event

El "Pull to actualización" Event debe contener el código para actualizar los datos:
  • en la Tabla o control Looper.
  • en la ventana.
Al final de la ejecución del código, la barra de actualización se ocultará automáticamente.
Atención: Una barra de progreso aparece durante la ejecución del "Pull to actualización" Event. Esta barra de progreso sólo se mostrará si el hilo principal puede ejecutarse durante la ejecución del "Pull to actualización" Event. Para ver la barra de progreso, el actualización Process largo (por ejemplo, solicitud HTTP o iteración HFSQL) debe realizarse en un hilo ejecutado desde el "Pull to actualización" Event. En este caso, la barra debe ser gestionada por las siguientes funciones:
Caso especial: control Tabla o Looper basado en un archivo de datos
If the pull-to- actualización feature us enabled on a Table or control Looper based on un archivo de datos , TableDisplay or LooperDisplay with the taReExecuteQuery constant will be automatically called after the "Pull to actualización " Event is executed (if triggered by a pull-to- actualización ).
Para desactivar este comportamiento, debe devolver False en el "Tirar a actualización" Event. Para obtener más información, consulte " Tirar a actualización" Event: gestión del bar.
Personalización de la función "Tirar a actualización "

Barra de refresco

Si se utiliza una barra actualización, esta barra corresponde a una ventana interna específica que puede incluirse en el proyecto para su personalización.
Esta ventana interna incluye 3 planos visualizados durante las diferentes etapas de "Tirar hacia actualización".:
  • El primer plano se muestra durante el desplazamiento, hasta que la barra de actualización se muestra por completo.
    Este plano incluye un Image y una leyenda. Esta leyenda describe la acción associated con el gesto actual.
  • El segundo plano se muestra durante el desplazamiento cuando la barra de actualización se muestra por completo hasta que el usuario suelta el puntero.
    Este plano incluye un Image y una leyenda. Esta leyenda describe la acción associated con el gesto actual. Al pasar del plano 1 al plano 2, la flecha cambia de dirección y el texto pasa a ser "Liberar a actualización"..
  • El último plano se muestra mientras se actualizan los datos.
    Este plano incluye un control Barra de progreso y una leyenda.
La ventana propuesta contiene tres eventos específicos para gestionar el gesto "Tirar a actualización ":
  • "Tire a actualización: Comenzar": Este código se llama cuando se detecta el gesto "Tirar a actualización ". Por defecto, esta Event posiciona la ventana interna en el plano 1 y modifica la leyenda de la acción.
  • "Tire a actualización: Espera la liberación": Esta Event se llama cuando se puede iniciar una actualización. Por defecto, esta Event posiciona la ventana interna en el plano 2 y modifica la leyenda de la acción.
  • "Tire a actualización: Actualizar": Esta Event se llama al iniciar la actualización. Por defecto, esta Event posiciona la ventana interna en el plano 3 y modifica la leyenda de la acción.
Cuando se incluyó la ventana interna en el proyecto, se puede:
  • personalizar la interfaz de la barra.
  • personalizar los eventos para la gestión de "Pull to actualización"..
  • acceder a los controles de la ventana interna a través de la siguiente sintaxis:
    <Name of Table or Looper control>.<Name of Internal Window>.<Control name>

" Tirar a actualización" Event: gestión del bar

Este Event puede gestionar el control (o ventana) actualización en un thread específico . En este caso, la visualización de la barra se puede gestionar manualmente mediante las siguientes funciones:
Ejemplo: El evento "Pull to actualización" de TABLE_Products ejecuta el ChangeReorder automatic Procedure una vez, con un delay de 3 segundos. .
// Display the refresh bar
TableRefreshVisible(TABLE_Products, True)
// Automatic refresh procedure
ChangeReorder()
Al final del procedimiento actualización, la barra actualización se borra utilizando de nuevo TableRefreshVisible.
PROCEDURE ChangeReorder()
IF NOT gbReorderPerformed THEN
FOR i = 1_TO_ TABLE_Products..Occurrence
IF TABLE_Products[i].COL_ID = gnReorderProductID THEN
TABLE_Products[i].COL_InStock = IMG_Stock_OK
END
END
END
// Delete the refresh bar
TableRefreshVisible(TABLE_Products, False)
Observación: Para ocultar la barra, debe realizar tantas llamadas a TableRefreshVisible(False) como llamadas a TableRefreshVisible(True).
Versión mínima requerida
  • Versión 20
Comentarios
Haga clic en [Agregar] para publicar un comentario

Última modificación: 22/11/2023

Señalar un error o enviar una sugerencia | Ayuda local