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

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

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

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

1. Lancement du test de l'application :
   
   
   Par défaut, le thème clair est utilisé.
2. Clic sur l'icône de passage au thème sombre : .
3. Affichage de la fenêtre en test 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.

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.

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

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

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

• 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ème	Permet de modifier par programmation le thème (sombre ou clair) utilisé par l'application mobile.
RécupèreThème	Permet de connaître le thème actuel d'une application mobile.
SysThème	Renvoie le thème visuel affiché actuellement sur le poste en cours.