• automatically adapt to the device theme settings. The dark theme will automatically be used.
• force the use of dark theme or light theme through programming.

Dark theme management

1. Open the project description window: on the "Project" tab, in the "Project" group, click "Description".
2. In the "Style" tab, check "Allow switching to dark theme (automatically or manually via ChangeTheme)".
   
3. Validate.

• The project is associated with a single skin template. This skin template corresponds to the light theme. Windows are always edited in light theme. The skin template used for the dark theme is BlackStellar.
• Tip: Use skin template styles if possible. If colors or images are fixed through programming, use the optional events "Application of light/dark theme" to use a specific color according to the theme used.

Testing an application that uses dark theme in the simulator

When dark theme is enabled in a WINDEV Mobile project, the simulator offers an additional option () allowing to switch the application from one theme to another.

1. Start the application test:
   
   
   The light theme is used by default.
2. Click the icon to switch to dark mode: .
3. window displayed with dark theme during test.
   

Special case: Do not use dark theme on a window

1. Open the window description (e.g. "Description", in the popup menu).
2. In the "Style" tab, check "Do not apply dark theme".
   
3. Validate the description window.

Overview

• "Application of light/dark theme", a new event to customize the switch to dark mode if necessary.
• WLanguage functions to find out, modify and retrieve the theme used.

Specific events

• When the application starts (after the "Initializing" event of the project).
• When the theme is changed in the code with ChangeTheme only if the withCodeExecution constant has been specified.
• When the system automatically changes the theme: modification of system settings, changing the day/night time, activating/deactivating the battery saver, etc.

• When the window is opened, after the "Global declarations" event and before the initialization events of the window controls.
• If the window is open when the theme is changed with ChangeTheme, only if the withCodeExecution constant has been specified.
• If the window is open when the system automatically changes the theme: modification of system settings, changing the day/night time, activating/deactivating the battery saver, etc.

• When loading the internal window, after the "Global declarations" event and before the initialization events of the internal window controls.
• If the internal window is loaded when changing the theme through programming with ChangeTheme, only if the withCodeExecution constant has been specified.
• It the internal window is loaded when the system automatically changes the theme: modification of system settings, changing the day/night time, activating/deactivating the battery saver, etc.

• if the application does not support dark theme.
• if the window ignores dark theme.

WLanguage functions

Versions 25 and later ChangeTheme New in version 25 ChangeTheme ChangeTheme	Is used to change, through programming, the theme (dark or light) used by the mobile application.
Versions 25 and later GetTheme New in version 25 GetTheme GetTheme	Is used to find out the current theme of a mobile application.
Versions 16 and later SysTheme New in version 16 SysTheme SysTheme	Returns the current theme used on the mobile device.