DOCUMENTATION EN LIGNE
DE WINDEVWEBDEV ET WINDEV MOBILE

Aide / Développer une application ou un site / Spécificités Mobile
  • Présentation
  • Mise en place
  • Gestion du thème sombre
  • Tester une application gérant le thème sombre dans le simulateur
  • Cas particulier : Ne pas utiliser le thème sombre sur une fenêtre
  • Programmation en WLangage
  • Présentation
  • Evénements spécifiques
  • Fonctions WLangage
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
Les dernières versions des OS mobiles permettent de passer les applications en thème sombre pour réduire la consommation de batterie ou pour faciliter l'utilisation de l'appareil dans un environnement peu éclairé.
WINDEV Mobile permet de gérer ce thème sombre dans vos applications mobiles. Il est possible de :
  • s'adapter automatiquement au paramétrage du thème du mobile. Le thème sombre sera alors automatiquement utilisé.
  • forcer le thème sombre ou le thème clair par programmation.
Mise en place

Gestion du thème sombre

Pour gérer le thème sombre dans une de vos applications mobiles :
  1. Affichez la fenêtre de description du projet : sous le volet "Projet", dans le groupe "Projet", cliquez sur "Description".
  2. Dans l'onglet "Style", cochez l'option "Autoriser le passage en thème sombre (automatique ou manuellement via la fonction ChangeThème)".
    Activation du thème sombre
  3. Validez.
Attention : Après l'utilisation de cette option, il est nécessaire de tester l'application afin de vérifier le bon fonctionnement de l'application pour vérifier que l'UI soit correcte.
Remarques :
  • Le projet est associé à un seul gabarit. Ce gabarit correspond au thème clair. Les fenêtres sont toujours éditées en thème clair. Le gabarit utilisé pour le thème sombre est le gabarit BlackStellar.
  • Astuce : Utilisez si possible les styles des gabarits. Si des couleurs ou images sont fixées par programmation, utilisez les événements optionnels "Application du thème clair/sombre" pour utiliser une couleur spécifique en fonction du thème utilisé.

Tester une application gérant le thème sombre dans le simulateur

Lorsque le thème sombre est géré pour un projet WINDEV Mobile, le simulateur propose une option supplémentaire () permettant de basculer l'application d'un thème à l'autre.
Exemple :
  1. Lancement du test de l'application :
    Test de la fenêtre avec le thème clair

    Par défaut, le thème clair est utilisé.
  2. Clic sur l'icône de passage au thème sombre : Passage au thème sombre.
  3. Affichage de la fenêtre en test avec le thème sombre.
    Test de la fenêtre avec le thème sombre

Cas particulier : Ne pas utiliser le thème sombre sur une fenêtre

Pour ne pas appliquer le thème sombre sur une des fenêtres de l'application :
  1. Affichez la fenêtre de description de la fenêtre (option "Description" du menu contextuel par exemple).
  2. Dans l'onglet "Style", cochez l'option "Ne pas appliquer le thème sombre".
  3. Validez la fenêtre de description.
Programmation en WLangage

Présentation

Après l'activation de la gestion du mode sombre, WINDEV Mobile propose :
  • un nouvel événement "Application du thème clair/sombre" pour personnaliser si nécessaire le passage au mode sombre.
  • des fonctions WLangage permettant de connaître, modifier et récupérer le thème utilisé.

Evénements spécifiques

Lors de l'activation de la gestion du thème sombre, un nouvel événement "Application du thème clair/sombre" est disponible au niveau du projet, au niveau des fenêtres et des fenêtres internes.
L'événement "Application du thème clair/sombre" du projet est exécuté dans les cas suivants :
  • Au lancement de l'application (après l'événement "Initialisation" du projet).
  • Lors du changement de thème réalisé par programmation avec la fonction ChangeThème uniquement si la constante avecExécutionDeCode a été spécifiée.
  • Lors du changement de thème automatiquement effectué par le système : modification des paramètres système, changement d'heure jour/nuit, activation/désactivation de l'économiseur de batterie, ...
L'événement "Application du thème clair/sombre" des fenêtres est un événement optionnel. Cet événement est exécuté dans les cas suivants :
  • A l'ouverture de la fenêtre, après l'événement "Déclarations globales" et avant les événements d'initialisation des champs de la fenêtre.
  • Si la fenêtre est ouverte lors du changement de thème réalisé par programmation avec la fonction ChangeThème uniquement si la constante avecExécutionDeCode a été spécifiée.
  • Si la fenêtre est ouverte lors du changement de thème automatiquement effectué par le système : modification des paramètres système, changement d'heure jour/nuit, activation/désactivation de l'économiseur de batterie, ...
L'événement "Application du thème clair/sombre" des fenêtres internes est un événement optionnel. Cet événement est exécuté dans les cas suivants :
  • Au chargement de la fenêtre interne, après l'événement "Déclarations globales" et avant les événements d'initialisation des champs de la fenêtre interne.
  • Si la fenêtre interne est chargée lors du changement de thème réalisé par programmation avec la fonction ChangeThème uniquement si la constante avecExécutionDeCode a été spécifiée.
  • Si la fenêtre interne est chargée lors du changement de thème automatiquement effectué par le système : modification des paramètres système, changement d'heure jour/nuit, activation/désactivation de l'économiseur de batterie, ...
Remarque : Ces événements ne sont pas exécutés :
  • si l'application ne gère pas le thème sombre.
  • si la fenêtre ignore le thème sombre.

Fonctions WLangage

Les fonctions WLangage permettant de gérer le thème sombre sont les suivantes :
ChangeThèmePermet de modifier par programmation le thème (sombre ou clair) utilisé par l'application mobile.
RécupèreThèmePermet de connaître le thème actuel d'une application mobile.
SysThèmeRenvoie le thème visuel affiché actuellement sur le poste en cours.
Version minimum requise
  • Version 25
Commentaires
Cliquez sur [Ajouter] pour publier un commentaire

Dernière modification : 07/04/2023

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