DOCUMENTATION EN LIGNE
DE WINDEVWEBDEV ET WINDEV MOBILE

Aide / Développer pour iOS (iPhone / iPad)
  • Présentation
  • Créer une fenêtre de type Widget iOS
  • Caractéristiques d'une fenêtre de type Widget iOS 14
  • Taille d'une fenêtre Widget
  • Mise à jour du contenu
  • Réaffichage de la fenêtre du Widget
  • Image et description du Widget
  • Programmation d'une fenêtre de type Widget iOS 14
  • Ouverture d'une fenêtre Widget
  • Fermeture d'une fenêtre Widget
WINDEV
WindowsLinuxUniversal Windows 10 AppJavaEtats et RequêtesCode Utilisateur (MCU)
WEBDEV
WindowsLinuxPHPWEBDEV - Code Navigateur
WINDEV Mobile
AndroidWidget AndroidiPhone/iPadWidget IOSApple WatchMac CatalystUniversal Windows 10 App
Autres
Procédures stockées
Présentation
Une application iOS avec une configuration Widget iOS peut contenir une ou plusieurs fenêtres de type Widget iOS 14. Ces fenêtres pourront être affichées sur l'écran d'accueil de la tablette ou du téléphone.
Les informations affichées dans ces fenêtres sont mises à jour régulièrement.

Créer une fenêtre de type Widget iOS

Pour créer une fenêtre de type Widget iOS dans une configuration Widget iOS :
  1. Cliquez sur parmi les boutons d'accès rapide :
    • La fenêtre de création d'un nouvel élément s'affiche : cliquez sur "Fenêtre" puis sur "Fenêtre".
    • L'assistant de création d'une fenêtre se lance.
  2. Dans l'onglet "Standard", dans la zone "Autre plateforme", sélectionnez l'option "Vierge pour Widget" et validez.
  3. Une nouvelle fenêtre est créée sous l'éditeur. Seuls 2 types de champs sont disponibles dans les fenêtres Widget iOS 14 : les champs Libellé et les champs Image.
Remarque : Il est également possible de modifier le type d'une fenêtre existante :
  1. Affichez la description de la fenêtre (option "Description" du menu contextuel).
  2. Dans l'onglet "UI", sélectionnez "Widget (Android/iOS14+)".
  3. Validez.
Caractéristiques d'une fenêtre de type Widget iOS 14

Taille d'une fenêtre Widget

La taille d'une fenêtre Widget est définie en nombre de cellules verticales et horizontales. Cette taille est paramétrable dans l'onglet "UI" de la fenêtre de description :
Sous iOS, plusieurs tailles standards sont utilisées :
  • Small.
  • Medium.
  • Large.
  • iOS 16 uniquement : Carré/Rectangle pour écran de verrouillage.
    Ces options permettent de créer des Widgets "Lock Screen" : ces Widgets sont apparents sur l'écran, même si le périphérique est verrouillé.
  • iOS 15 : Extra large.
Il est également possible de choisir d'autres tailles.
Remarque : Les Widgets créés avec WINDEV Mobile ne sont pas redimensionnables.
Un Widget peut être proposé dans une seule ou plusieurs de ces tailles, par exemple en mode "Small" et en mode "Medium".
Sous WINDEV Mobile, pour proposer un même Widget dans différentes tailles, il est nécessaire de :
  • Créer une fenêtre de type "Widget iOS 14" pour chacune des tailles voulues. Chaque fenêtre possède un nom différent.
  • Définir le même titre pour chacune des fenêtres. Ce titre permettra de regrouper les différentes tailles du Widget.

Mise à jour du contenu

Les fenêtres de type Widget possèdent un événement spécifique : Rafraîchissement du Widget. Cet événement permet de mettre à jour le contenu du Widget. Cet événement est lancée à intervalle de temps régulier. La fréquence de rafraîchissement est fixée dans l'onglet "UI" de la fenêtre de description.
Remarques :
  • Cette fréquence de rafraîchissement ne peut pas être inférieure à 30 minutes.
  • La fonction WidgetAffiche provoque le ré-affichage du Widget et l'exécution de l'événement "Rafraîchissement du Widget".

Réaffichage de la fenêtre du Widget

L'affichage du dessin d'une fenêtre Widget est effectué par le processus qui gère l'écran d'accueil de l'appareil. Cet affichage de la fenêtre du Widget n'est pas effectué en permanence. Il est mis à jour dans les cas suivants :
  • Ajout d'une nouvelle instance du Widget sur l'écran d'accueil.
  • Après un clic sur un bouton ou une image du Widget.
  • Après la mise à jour du contenu du Widget.
Remarque : La fonction WidgetAffiche provoque le ré-affichage du Widget et l'exécution de l'événement "Rafraîchissement du Widget".

Image et description du Widget

Lors de l'installation d'un Widget sur le bureau, l'utilisateur dispose de la liste des Widgets présents sur son poste. Cette liste contient pour chaque Widget :
  • le nom du Widget,
  • sa description,
  • l'image d'aperçu (pour chaque taille disponible).
Le nom du Widget correspond au titre de la fenêtre. Si plusieurs fenêtres de tailles différentes ont le même titre, ces fenêtres seront proposées pour les différentes tailles du Widget.
La description du Widget est saisie dans l'onglet "UI" de la fenêtre de description de la fenêtre.
Cette description peut être saisie dans plusieurs langues. Si plusieurs fenêtres sont disponibles pour un Widget, la description de la fenêtre la plus petite est prise en compte.
L'image d'aperçu du Widget est générée automatiquement.
Remarque : Si une image est spécifiée dans l'onglet "UI" de la fenêtre de description, elle ne sera pas prise en compte.
Programmation d'une fenêtre de type Widget iOS 14

Ouverture d'une fenêtre Widget

Il n'est pas possible de demander explicitement l'ouverture d'une fenêtre de type Widget. Les fonctions d'ouverture (OuvreSoeur, OuvreFille, Utilise) déclencheront une erreur fatale si elles sont utilisées en mode Widget.
Les fenêtres de type Widget sont automatiquement ouvertes dans les cas suivants :
  • Ajout sur l'écran d'accueil de la première instance du Widget correspondant à la fenêtre.
  • Après le démarrage de l'appareil si au moins une instance du Widget est présente sur l'écran d'accueil.
  • Lors de la mise à jour du Widget ou en cas d'interaction de l'utilisateur avec le Widget (clic sur un bouton par exemple).
  • Dans le cas où le processus a été stoppé par le système (s'il a besoin de ressources par exemple).
Les événements exécutés lors de l'ouverture d'une fenêtre de type Widget sont les suivants :
  • "Déclaration globales" de la fenêtre.
  • "Initialisation" des champs de la fenêtre.
  • "Initialisation" de la fenêtre.
  • "Fin d'initialisation" de la fenêtre.
  • "Rafraîchissement du Widget".
L'événement "Initialisation" associé au projet sera exécuté uniquement avant l'ouverture de la première fenêtre de type Widget de l'application. Pour différencier le code spécifique aux Widgets du code spécifique à l'application dans cet événement, utilisez la fonction EnModeWidget.

Fermeture d'une fenêtre Widget

Il n'est pas possible de demander explicitement la fermeture d'une fenêtre de type Widget. La fonction Ferme déclenchera une erreur fatale si elle est utilisée en mode Widget.
Les fenêtres de type Widget sont automatiquement fermées lorsque la dernière instance du Widget est retirée de l'écran d'accueil. L'événement "Fermeture" (associé à la fenêtre) est exécuté lors de la fermeture d'une fenêtre de type Widget.
L'événement "Fermeture" associé au projet sera exécuté lorsque la dernière instance d'un Widget de l'application est retirée de l'écran d'accueil et qu'il n'y a plus aucune instance affichée d'autres Widgets de l'application.
Version minimum requise
  • Version 26
Commentaires
Cliquez sur [Ajouter] pour publier un commentaire

Dernière modification : 09/06/2023

Signaler une erreur ou faire une suggestion | Aide en ligne locale