PC SOFT

DOCUMENTATION EN LIGNE
DE WINDEV, WEBDEV ET WINDEV MOBILE

  • 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
Produits
WINDEVWEBDEV - Code ServeurWEBDEV - Code NavigateurWINDEV MobileEtats et Requêtes
Plateformes
WindowsLinuxWindows MobileUniversal Windows 10 AppAndroidWidget AndroidiPhone/iPadApple Watch
Langages
JavaPHPAjaxCode Utilisateur (MCU)Langage Externe
Bases de données
HFSQLHFSQL Client/ServeurProcédures stockéesOLE DBODBCAccès Natifs
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 :
    • Dans la roue qui s'affiche, cliquez sur "Fenêtre". 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", 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.
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 "Détail", sélectionnez "Widget (Android)".
  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 "Détail" 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 traitement spécifique : Rafraîchissement du Widget. Ce traitement permet de mettre à jour le contenu du Widget. Ce traitement est effectué à intervalle de temps régulier. Cet intervalle est fixé dans l'onglet "Détail" de la fenêtre de description.
Remarques :
  • Ce taux de rafraîchissement ne peut pas être inférieur à 30 minutes.
  • La fonction WidgetAffiche provoque le réaffichage du Widget et l'exécution du traitement de rafraîchissement.

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 du traitement de rafraîchissement.

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 "Détail" 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 traitements exécutés lors de l’ouverture d’une fenêtre de type Widget sont les suivants :
  • Déclaration des globales.
  • Initialisation des champs de la fenêtre.
  • Initialisation de la fenêtre.
  • Rafraîchissement du Widget.
Le traitement d’initialisation du projet sera exécuté uniquement avant l’ouverture de la première fenêtre de type Widget de l’application. Dans le traitement d’initialisation du projet, pour différencier le code spécifique aux Widgets du code spécifique à l’application, 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.
Le traitement "Fermeture de la fenêtre" est exécuté lors de la fermeture d’une fenêtre de type Widget.
Le traitement de fermeture du 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