Home · All Classes · Grouped Classes · Annotated · Functions

StandardDialogs Namespace Reference

The StandardDialogs namespace contains methods to disable Qtopia's standard dialog popups. More...

    #include <StandardDialogs>

Functions


Detailed Description

The StandardDialogs namespace contains methods to disable Qtopia's standard dialog popups.

The core Qtopia sub-systems often generate information that needs to be displayed to the user. To ease customizability, all the simple dialogs and notifications in Qtopia are collectively managed in one place - the StandardDialogs server task.

To customize one of these dialogs, an integrator needs only to implement their own version and disable Qtopia's default behaviour through one of the methods available in the StandardDialogs namespace.

The documentation for each of the following methods lists both what the dialog it disables is, as well as the system behaviour to which it responds. The intent is to make the task of replicating each very simple.


Function Documentation

void StandardDialogs::disableDefaultCrashDialog ()

The default crash handler dialog appears whenever an unfiltered application crash occurs. An application crash may be filtered by the ApplicationTerminationHandler interface. The default implementation is a standard QMessageBox alerting the user to the name of the crashed application.

The dialog appears whenever the ApplicationLauncher::applicationTerminated() signal is emitted with the filtered parameter set to false.

Invoking this method will disable the default crash dialog.

void StandardDialogs::disablePowerAlertDialog ()

The power alert dialog appears whenever the device battery runs low. The default implementation is a standard QMessageBox 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.

Invoking this method will disable the power alert dialog.

void StandardDialogs::disablePreloadCrashDialog ()

The preload crash dialog appears whenever a preloaded application crashes. The default implementation is a standard QMessageBox alerting the user to the name of the crashed application, and informing them that it has been removed from the preload list.

The dialog appears whenever the StartupApplications::preloadCrashed() signal is emitted.

Invoking this method will diable the preload crash dialog.

void StandardDialogs::disableShutdownDialog ()

The shutdown dialog allows users to terminate Qtopia, restart Qtopia, shutdown the system or reboot the system. The default implementation is a simple dialog allowing the user to select from one of these four options.

The shutdown dialog appears in response to the QtopiaServerApplication::shutdownRequested() signal. Once the user has selected their desired option, the dialog invokes the QtopiaServerApplication::shutdown() method and closes.

Invoking this method will disable the shutdown dialog.

void StandardDialogs::disableTerminationHandlerDialog ()

Applications can install custom termination messages using the QTerminationHandler class. The default implementation displays a standard QMessageBox alerting th euser to the termination and the specified reason.

The dialog appears whenever the QTerminationHandlerProvider class emits the QTerminationHandlerProvider::applicationTerminated() signal.

Invoking this method will disable the default termination handler dialog.

void StandardDialogs::disableVolumeDialog ()

The volume dialog provides users the feedback on volume changes.

The volume dialog appears in response to the MediaServicesTask::volumeChanged() signal.


Copyright © 2008 Nokia Trademarks
Qtopia 4.3.3