AYUDA EN LÍNEA
 WINDEVWEBDEV Y WINDEV MOBILE

Ayuda / Desarrollar para iOS (iPhone/iPad)
  • Presentación
  • Crear una ventana de tipo widget iOS
  • Características de una ventana de tipo widget para iOS
  • Tamaño de la ventana widget
  • Actualizar el contenido
  • Volver a mostrar la ventana widget
  • Imagen y descripción del widget
  • Programación de una ventana de tipo widget para iOS
  • Abrir una ventana widget
  • Cerrar una ventana widget
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
Una aplicación iOS con una configuración "Widget iOS" puede contener una o varias ventanas de tipo widget para iOS 14. Estas ventanas pueden mostrarse en la pantalla de inicio de una tableta o teléfono.
La información que aparece en estas ventanas se actualiza periódicamente.

Crear una ventana de tipo widget iOS

Para crear una ventana de tipo widget en una configuración "Widget iOS":
  1. Haga clic en en los botones de acceso rápido:
    • La ventana de creación de nuevos elementos se abre: haga clic en "Ventana", y luego en "Ventana".
    • El asistente de creación de ventanas se abre.
  2. En la pestaña "Estándar", en el área "Otra plataforma", seleccione "En blanco para widget" y valide.
  3. Una nueva ventana se crea en el editor. Solo hay dos tipos de controles disponibles para las ventanas widget: controles Estático y controles Imagen.
Observación: También puede cambiar el tipo de una ventana existente:
  1. Abra la descripción de la ventana (opción "Descripción" del menú contextual).
  2. En la pestaña "IU", seleccione "Widget (Android/iOS14+)".
  3. Valide.
Características de una ventana de tipo widget para iOS

Tamaño de la ventana widget

El tamaño de una ventana widget depende del número de celdas que ocupa horizontal y verticalmente. Este tamaño puede configurarse en la pestaña "UI" de la ventana de descripción:
En iOS, hay varios tamaños estándar:
  • Small.
  • Medium.
  • Large.
  • Solo para iOS 16: Cuadrado o rectángulo para la pantalla de bloqueo.
    Estas opciones permiten crear widgets para la pantalla de bloqueo: estos widgets son visibles en la pantalla, incluso si el dispositivo está bloqueado.
  • iOS 15: extra large.
También es posible elegir otros tamaños.
Observación: Los widgets creados con WINDEV Mobile no se pueden redimensionar.
Los widgets pueden tener uno o varios tamaños (por ejemplo, "Small" y "Medium").
Para crear el mismo widget en diferentes tamaños en WINDEV Mobile, debe:
  • Crear una ventana de tipo "Widget iOS 14" para cada tamaño deseado. Cada ventana tiene un nombre diferente.
  • Definir el mismo título para cada ventana. Este título se utilizará para agrupar los diferentes tamaños del widget.

Actualizar el contenido

Las ventanas de tipo widget incluyen un evento específico: Actualización del widget. Este evento actualiza el contenido del widget. Este evento se ejecuta a intervalos de tiempo regulares. La frecuencia de actualización se define en la pestaña "UI" de la ventana de descripción.
Observaciones:
  • Esta frecuencia de actualización no puede ser inferior a 30 minutos.
  • La función WidgetDisplay vuelve a mostrar el widget y ejecuta el evento "Actualización del widget".

Volver a mostrar la ventana widget

El proceso que gestiona la pantalla de inicio del dispositivo muestra la ventana widget. La ventana widget no se actualiza constantemente. Se actualiza en los siguientes casos:
  • Cuando se agrega una instancia del widget a la pantalla de inicio.
  • Cuando se pulsa un botón o una imagen del widget.
  • Cuando se actualiza el contenido del widget.
Observación: La función WidgetDisplay vuelve a mostrar el widget y ejecuta el evento "Actualización del widget".

Imagen y descripción del widget

Al instalar un widget en el escritorio, los usuarios pueden ver la lista de widgets en sus equipos. Por cada widget, la lista muestra:
  • el nombre del widget,
  • la descripción,
  • la imagen de vista previa (para cada tamaño disponible).
El nombre del widget corresponde al título de la ventana. Si varias ventanas de distintos tamaños tienen el mismo título, se sugerirán para los diferentes tamaños del widget.
La descripción del widget puede describirse en la pestaña "UI" de la descripción de la ventana.
Esta descripción puede introducirse en varios idiomas. Si hay varias ventanas para un widget, se utiliza la descripción de la ventana más pequeña.
La imagen de vista previa del widget se genera automáticamente.
Observación: Si se especifica una imagen en la pestaña "UI" de la ventana de descripción, no se tendrá en cuenta.
Programación de una ventana de tipo widget para iOS

Abrir una ventana widget

No puede abrir una ventana de tipo widget directamente. Las funciones de apertura (OpenSister, OpenChild, Use) provocarán un error fatal si se utilizan en modo widget.
Las ventanas de tipo widget se abren automáticamente en los siguientes casos:
  • Cuando la primera instancia del widget que corresponde a la ventana se agrega a la pantalla de inicio.
  • Después de iniciar el dispositivo, si al menos una instancia del widget está presente en la pantalla de inicio.
  • Cuando se actualiza el widget o cuando el usuario interactúa con él (pulsa un botón, por ejemplo).
  • Si el sistema detuvo el proceso (si necesita recursos, por ejemplo).
Los siguientes eventos se ejecutan cuando se abre una ventana de tipo widget:
  • "Declaraciones globales" de la ventana.
  • Evento "Inicialización" de los controles.
  • Evento "Inicialización" de la ventana.
  • Evento "Fin de inicialización" de la ventana.
  • "Actualización del widget".
El evento "Inicialización" del proyecto solo se ejecutará antes de que se abra la primera ventana de tipo widget de la aplicación. Para diferenciar el código específico del widget del código específico de la aplicación en este evento, utilice la función InWidgetMode.

Cerrar una ventana widget

No puede cerrar directamente una ventana de tipo widget. La función Close provocará un error fatal si se utiliza en modo widget.
Las ventanas de tipo widget se cierran automáticamente cuando se quita la última instancia del widget de la pantalla de inicio. El evento "Cierre" de la ventana se ejecuta cuando se cierra una ventana de tipo widget.
El evento "Cierre" del proyecto se ejecutará cuando se elimine la última instancia de un widget de la aplicación de la pantalla de inicio y no se muestren más instancias de otros widgets.
Versión mínima requerida
  • Versión 26
Comentarios
Haga clic en [Agregar] para publicar un comentario

Última modificación: 12/06/2023

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