Modifies the setting of the brightness for the device screen.
Remark: This function can be used in the emulator.
// Applies a maximum brightness to the screen
<Brightness>: Integer or Integer constant
New value for the brightness:
- value included between 0 and 100.
- the following constant:
|brightnessAuto||The screen lightness is automatically adapted according to the lighting conditions.|
Caution: This constant is available from Android version 2.2 (api level 8). The function will have no effect if it used with an earlier version of the system.
To find out whether the automatic management of the brightness is enabled, use BrightnessAuto
- The modification of the brightness affects the setting of the device. Therefore, the new brightness is global to all the applications and it will be stored when the application is closed.
- To find out the value of the current setting for the brightness of the screen, use BrightnessGet.
- We advise you not to specify a very low brightness (less than 10). Indeed, the minimum brightness changes according to the device and the screen of the phone can be switched off if the limit is reached.
The call to this function modifies the permissions required by the application.
Required permission : WRITE_SETTINGS
This permission allows the application to write the system parameters.
Cross-platform examples (WINDEV Mobile): WM System