Une application Android peut contenir une ou plusieurs fenêtres de type Widget. Ces fenêtres pourront être affichées sur l'écran d'accueil de la tablette ou du téléphone.

Créer une fenêtre de type Widget Android

Pour créer une fenêtre de type Widget Android :

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 3 types de champs sont disponibles dans les fenêtres Widget : les champs Bouton, les champs Libellé et les champs Image.

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.

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 :

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.

• 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 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.

Image 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 et l'image d'aperçu.

• de fournir une image spécifique.
• de générer une copie d'écran de la fenêtre. Dans ce cas, la copie d'écran est automatiquement associée à l'image d'aperçu.

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.

• 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).

• "Déclaration globales" de la fenêtre.
• "Initialisation" des champs de la fenêtre.
• "Initialisation" de la fenêtre.
• "Rafraîchissement du Widget".

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.