Home · All Namespaces · All Classes · Grouped Classes · Modules · Functions

QAbstractHomeScreen Class Reference
[QtBaseModule]

The QAbstractHomeScreen class allows developers to replace the "home screen" portion of the Phone UI. More...

    #include <QAbstractHomeScreen>

Inherits QWidget.

Inherited by BasicHomeScreen.

• List of all members, including inherited members

Public Functions

• QAbstractHomeScreen ( QWidget * parent = 0, Qt::WFlags flags = 0 )
• ~QAbstractHomeScreen ()
• virtual bool locked () const = 0
• virtual void setLocked ( bool state ) = 0
• virtual bool simLocked () const = 0

• 206 public functions inherited from QWidget
• 29 public functions inherited from QObject
• 14 public functions inherited from QPaintDevice

Signals

• void callEmergency ( const QString & number )
• void dialNumber ( const QString & number )
• void hangupCall ()
• void lockStateChanged ( bool locked )
• void showCallHistory ()
• void showCallScreen ()
• void showMissedCalls ()
• void showPhoneBrowser ()
• void speedDial ( const QString & speeddial )

• 1 signal inherited from QWidget
• 1 signal inherited from QObject

Additional Inherited Members

• 57 properties inherited from QWidget
• 1 property inherited from QObject
• 19 public slots inherited from QWidget
• 1 public slot inherited from QObject
• 1 public type inherited from QObject
• 4 static public members inherited from QWidget
• 4 static public members inherited from QObject
• 38 protected functions inherited from QWidget
• 7 protected functions inherited from QObject
• 1 protected function inherited from QPaintDevice
• 1 protected slot inherited from QWidget
• 2 protected variables inherited from QObject
• 1 protected type inherited from QPaintDevice

Detailed Description

The QAbstractHomeScreen class allows developers to replace the "home screen" portion of the Phone UI.

The QAbstractHomeScreen interface is part of the server widgets framework and allows developers to replace the standard home/idle screen in the Qt Extended phone UI. A small tutorial on how to develop new server widgets using one of the abstract widgets as base can be found in QAbstractServerInterface class documentation.

The QAbstractHomeScreen interface is marked as singleton interface. For more details about the concept of singleton server widgets refer to the server widget documentation.

If a homescreen implementation provides a display area for user messages (such as Network registration or Location information) it should use the MessageBoard task to subscribe to new messages from the system.

Integration hints and requirements

For integration purposes any HomeScreen should support the following features:

Background image

The HomeScreen should listen on the QPE/System qcop channel for applyHomeScreenImage() messages. This message is sent when the user sets a new background image/wallpaper for the HomeScreen. The image information are stored in the Trolltech/qpe settings file. The HomeScreen/HomeScreenPicture key stores the image path and HomeScreen/HomeScreenPictureMode gives an indication how the image should be layed out (ScaleAndCrop, Center/Tile, Scale and Stretch). The Homescreen is closely linked to the HomeScreen settings application which is used to set these values.

General HomeScreen information

The HomeScreen should listen on the QPE/System qcop channel for updateHomeScreenInfo() messages. This message is sent when the user changes the items to be displayed on the HomeScreen. The HomeScreen settings application stores the following values in the Trolltech/qpe settings file:

This class is part of the Qt Extended server and cannot be used by other Qt Extended applications.

See also MessageBoard.

Member Function Documentation

QAbstractHomeScreen::QAbstractHomeScreen ( QWidget * parent = 0, Qt::WFlags flags = 0 )

Creates a new QAbstractHomeScreen instance with the given parent and flags.

QAbstractHomeScreen::~QAbstractHomeScreen ()

Destroys the QAbstractHomeScreen instance.

void QAbstractHomeScreen::callEmergency ( const QString & number )   [signal]

This signal is emitted when the user has chosen to dial the emergency number. Since the HomeScreen is not the usual place for dial input this only happens while the HomeScreen is locked. Otherwise the user would enter the dialer to dial the emergency number.

void QAbstractHomeScreen::dialNumber ( const QString & number )   [signal]

This signal is emitted when the user dials a number. The connecting slot should show the dial screen.

See also QAbstractDialerScreen.

void QAbstractHomeScreen::hangupCall ()   [signal]

This signal is emitted when the user presses the hangup key while on the HomeScreen. the connecting slot should hang the currently active call up.

void QAbstractHomeScreen::lockStateChanged ( bool locked )   [signal]

This signal is emitted when the current locking state of the HomeScreen changes to locked.

See also locked() and setLocked().

bool QAbstractHomeScreen::locked () const   [pure virtual]

Returns true if the homescreen is locked. This mode can be set by the user if he wants to prevent accidental input while the device is e.g. in his pocket.

The Qt Extended default implementation disinguishes between a touchscreen and a keypad based lock. To disengage the touchscreen lock the user has to perform a sliding gesture whereas the keypad lock requires the pressing of certain key combination.

See also setLocked().

void QAbstractHomeScreen::setLocked ( bool state )   [pure virtual]

Sets the current lock state of the HomeScreen to state.

See also locked().

void QAbstractHomeScreen::showCallHistory ()   [signal]

This signal is emitted when the callhistory should be shown.

See also QAbstractCallHistory.

void QAbstractHomeScreen::showCallScreen ()   [signal]

This signal is emitted when the call screen is required. the connecting slot should show the call screen.

See also QAbstractCallScreen.

void QAbstractHomeScreen::showMissedCalls ()   [signal]

This signal is emitted when the list of missed calls should be shown. The most likely reaction to this signal is very similar to the showCallHistory() signal with the difference that the shown list should have a filter applied that only accepts missed calls.

void QAbstractHomeScreen::showPhoneBrowser ()   [signal]

This signal is emitted when the user changes to the application browser window. Usually this is indicated by pressing the select key. The connecting slot should open the application browser screen.

See also QAbstractBrowserScreen.

bool QAbstractHomeScreen::simLocked () const   [pure virtual]

Returns true if the HomeScreen is locked due to a missing or not yet entered SIM PIN. This state can be left by entering the correct SIM PIN.

See also setLocked() and locked().

void QAbstractHomeScreen::speedDial ( const QString & speeddial )   [signal]

This signal is emitted when the user performs a speedial operation. A speeddial operation is usually indicated by a press and hold key action.