DOCUMENTATION EN LIGNE
DE WINDEVWEBDEV ET WINDEV MOBILE

Aide / Développer pour Android
  • Présentation
  • Créer une fenêtre de type Widget Android
  • Caractéristiques d'une fenêtre de type Widget Android
  • Taille d'une fenêtre Widget
  • Mise à jour du contenu
  • Réaffichage de la fenêtre du Widget
  • Image du Widget
  • Programmation d'une fenêtre de type Widget Android
  • 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
Fenêtres Widget Android
Présentation
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.
Les informations affichées dans ces fenêtres sont mises à jour régulièrement. Les fenêtres de type Widget permettent des interactions simples avec l'utilisateur.

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.
    Attention : Les styles des champs d'un Widget définis en édition seront ignorés en exécution. Il est uniquement possible de définir la couleur de fond des champs et l'image de fond pour les champs Bouton.
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 Android

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 :
Une cellule a pour taille 74 pixels de côté (pour un dpi de 160).
Pour un affichage compatible avec la plupart des appareils (téléphones et tablettes), il est conseillé de ne pas dépasser une taille de 4 x 4 cellules.
Remarque : Les Widgets créés avec WINDEV Mobile ne sont pas redimensionnables.

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 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 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.
L'image d'aperçu du Widget est définie dans l'onglet "UI" de la fenêtre de description.
Il est possible :
  • 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.
Si aucune image n'est spécifiée, l'icône de l'application Android sera automatiquement utilisée.
Programmation d'une fenêtre de type Widget Android

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