PowerAlertDialogTask Class Reference
[QtMediaModule]

Detailed Description

The PowerAlertDialogTask class provides a alert dialog that notifies the user when the battery is running low.

The PowerAlertDialogTask provides a Qt Extended Server Task and cannot be used by other Qt Extended applications. It displays the power alert dialog whenever the device battery runs low. The default implementation is a standard message box and an audible sound alerting the user to the low power situation.

The dialog appears when the battery level is very low or critical. The dialog will be redisplayed every five minutes, when very low, or every minute, when critical, until the power state improves or the device is placed on a charger. The default implementation uses the QPowerStatus to determine this information.

The period at which the power alert dialog redisplays can be configured by setting the PowerAlertDialog/DisplayPeriod and PowerAlertDialog/CriticalDisplayPeriod values to the period in seconds in the Trolltech/HardwareAccessories configuration file. If not specified the default values of 300 seconds (5 minutes) and 60 seconds are used for PowerAlertDialog/DisplayPeriod and PowerAlertDialog/CriticalDisplayPeriod respectively. Setting PowerAlertDialog/DisplayPeriod to 0 disables the power alert dialog.