Home · All Classes · Grouped Classes · Annotated · Functions

QPhoneProfileManager Class Reference

The QPhoneProfileManager class allows applications to control phone profiles. More...

    #include <QPhoneProfileManager>

Inherits QObject.

Public Functions

Signals

Additional Inherited Members


Detailed Description

The QPhoneProfileManager class allows applications to control phone profiles.

Qtopia's phone profiles are stored in the Trolltech/PhoneProfile configuration file. A device may have any number of integrator or user defined profiles. Each profile has a unique integer identifier which is used to refer to it by the system.

To activate a profile manually use the QPhoneProfileManager::activateProfile() method.

See also QPhoneProfile and QPhoneProfileProvider.


Member Function Documentation

QPhoneProfileManager::QPhoneProfileManager ( QObject * parent = 0 )

Constructs a new QPhoneProfileManager with the given parent.

QPhoneProfileManager::~QPhoneProfileManager ()   [virtual]

Destroys the QPhoneProfileManager object.

bool QPhoneProfileManager::activateProfile ( int profile )

Returns true if able to activate the profile id; otherwise returns false. If profile is -1 or the specified profile does not exist, a null (default values) profile will be activated.

bool QPhoneProfileManager::activateProfile ( const QPhoneProfile & profile )

This is an overloaded member function, provided for convenience.

Returns true if able to activates the profile; otherwise returns false. If profile has not been saved, the saved version with the same QPhoneProfile::id() will be activated.

This call is equivalent to activateProfile(profile.id()).

QPhoneProfile QPhoneProfileManager::activeProfile () const

Returns the currently active profile, or a null profile if no profile is active.

void QPhoneProfileManager::activeProfileChanged ( const QPhoneProfile & profile )   [signal]

This signal is emitted whenever the active profile changes or is updated.

QPhoneProfile QPhoneProfileManager::newProfile ()

Returns a new QPhoneProfile instance with its id set to the next available integer.

bool QPhoneProfileManager::planeMode () const

Returns true if plane mode is active; otherwise returns false. Plane mode is active if either it is overridden or the plane mode for the active profile is true.

See also planeModeOverride() and QPhoneProfile::planeMode().

bool QPhoneProfileManager::planeModeAvailable () const

Returns true if plane mode is available; otherwise returns false.

void QPhoneProfileManager::planeModeChanged ( bool enabled )   [signal]

This signal is emitted whenever the plane mode state changes. When plane mode is on enabled is true; otherwise false.

bool QPhoneProfileManager::planeModeOverride () const

Returns true if plane mode override is on; otherwise returns false. The plane mode override allows plane mode to be enabled, even if the active profile does not specify it as such.

See also setPlaneModeOverride() and QPhoneProfile::planeMode().

QPhoneProfile QPhoneProfileManager::profile ( int id ) const

Returns a QPhoneProfile for the given id if exists; otherwise returns a null QPhoneProfile.

void QPhoneProfileManager::profileAdded ( const QPhoneProfile & profile )   [signal]

This signal is emitted when a new profile is added.

QList<int> QPhoneProfileManager::profileIds () const

Returns a list of ids for all configured profiles.

void QPhoneProfileManager::profileRemoved ( const QPhoneProfile & profile )   [signal]

This signal is emitted when profile is removed.

void QPhoneProfileManager::profileUpdated ( const QPhoneProfile & profile )   [signal]

This signal is emitted whenever profile is updated.

QList<QPhoneProfile> QPhoneProfileManager::profiles () const

Returns all configured phone profiles.

void QPhoneProfileManager::removeProfile ( const QPhoneProfile & profile )

Removes profile. If profile is a null profile, no action will be taken.

If profile is active, the default profile (QPhoneProfile::id() == 1) will be activated.

void QPhoneProfileManager::saveProfile ( const QPhoneProfile & profile )

Saves the specified profile.

Saving a profile will overwrite any previously saved information.

void QPhoneProfileManager::setPlaneModeOverride ( bool mode )

Sets the current plane mode override state to mode.

See also planeModeOverride().

void QPhoneProfileManager::sync ()

Forces the re-reading of the profile information.


Copyright © 2008 Nokia Trademarks
Qtopia 4.3.3