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

• void disableCriticalMemoryPopup ()
• void disableDefaultCrashDialog ()
• void disablePowerAlertDialog ()
• void disablePreloadCrashDialog ()
• void disableShutdownDialog ()
• void disableTerminationHandlerDialog ()
• void disableVolumeDialog ()

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::disableCriticalMemoryPopup ()

The critical memory popup dialog appears whenever the memory available to the device becomes dangerously low. The default implementation is a standard QMessageBox alerting the user to close any unnecessary applications.

The dialog appears 20 seconds after the MemoryMonitor::memoryState() becomes MemoryMonitor::MemVeryLow. The 20 second delay is an attempt to prevent the dialog from exacerbating the situation.

Invoking this method will disable the default critical memory popup.

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 alerting the user to the low power situation.

The dialog appears:

Immediately when the QPowerStatus::batteryStatus() is reported as Critical. 30 seconds after the QPowerStatus::backupBatteryStatus() is reported as VeryLow. 60 seconds after the QPowerStatus::batteryStatus() is reported as VeryLow.

The dialog will be redisplayed every five minutes until the power state changes or a higher priority (as listed) case occurs. The default implementation uses the QPowerStatusManager to determine this information.

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.