Home · All Classes · Grouped Classes · Annotated · Functions

StandardDeviceFeatures Namespace Reference

The StandardDeviceFeatures namespace contains methods to disable Qtopia's standard device feature handling. More...

    #include <StandardDeviceFeatures>

Functions


Detailed Description

The StandardDeviceFeatures namespace contains methods to disable Qtopia's standard device feature handling.

The core Qtopia sub-systems rely on various device specific status information being maintained in the value space. To ease customizability, all the simple hardware device monitoring in Qtopia are collectively managed in one place - the StandardDeviceFeatures server task.

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

The documentation for each of the following methods lists both what device it monitors, as well as the expected result when the device state changes. The intent is to make the task of replicating each very simple.


Function Documentation

void StandardDeviceFeatures::disableCameraMonitor ()

The camera monitor detects when camera are available on the device and advertises them using the QtopiaFeatures API as the "Camera" feature.

Invoking this method will disable the default camera monitoring.

void StandardDeviceFeatures::disableClamshellMonitor ()

The clamshell monitor is responsible monitoring when a clamshell style phone (flip phone) is opened or closed and updating the value space. The value that must be maintained is:

/Hardware/Device/ClamshellOpen - true if the clamshell is in an open state.

The default clamshell monitoring uses Qt::Key_Flip press events to indicate a closed state and Qt::Key_Flip release events to indicate an open state.

Invoking this method will disable the default clamshell monitoring.

void StandardDeviceFeatures::disableInputFeatures ()

The QtopiaFeatures class allows applications to query certain properties about the Qtopia configuration. Based on the configured input modes, the following features are set automatically:

FeatureDescription
TouchscreenThe primary input for the device is via a touchscreen. That is, Qtopia::mousePreferred() == true.
CalibrateThe touch screen device requires calibration. This is set if Touchscreen is set.
KeyPadThe primary input for the device is via a keypad. That is, Qtopia::mousePreferred() == false.

.

The device integrator can override these default features by setting the Device/Input value in Qtopia's defaultbuttons configuration file. The value should be a comma separated list of the features to set. If any features are specified in this manner, the automatic features above are not set.

Invoking this method will disable the setting of features automatically.

void StandardDeviceFeatures::disableUITimeValues ()

The current system date and time is kept updated in the following value space keys:

KeyDescription
/UI/DisplayTime/TimeThe current time with minute resolution (eg "22:13").
/UI/DisplayTime/DateThe current date in expanded form (eg. "31 Aug 06").
/UI/DisplayTime/BriefDateThe current date in reduced form (eg. "31/08/06").

While it is possible, and correct, for applications to source this information directly through the QTime and QDate APIs, these values can be used for displaying the time in title bars or other incidental locations. By doing so, these time or date displays will remain in sync with one another.

Invoking this method will disable the creation and updating of the listed value space keys.


Copyright © 2008 Nokia Trademarks
Qtopia 4.3.3