QAbstractHomeScreen Class Reference
[QtBaseModule]

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.