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

QPhoneProfileManager Class Reference
[QtBaseModule]

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

    #include <QPhoneProfileManager>

Inherits QObject.

• List of all members, including inherited members

Public Functions

• QPhoneProfileManager ( QObject * parent = 0 )
• virtual ~QPhoneProfileManager ()
• bool activateProfile ( int profile )
• bool activateProfile ( const QPhoneProfile & profile )
• QPhoneProfile activeProfile () const
• QPhoneProfile newProfile ()
• bool planeMode () const
• bool planeModeAvailable () const
• bool planeModeOverride () const
• QPhoneProfile profile ( int id ) const
• QList<int> profileIds () const
• QList<QPhoneProfile> profiles () const
• void removeProfile ( const QPhoneProfile & profile )
• void saveProfile ( const QPhoneProfile & profile )
• void setPlaneModeOverride ( bool mode )
• void sync ()

• 29 public functions inherited from QObject

Signals

• void activeProfileChanged ( const QPhoneProfile & profile )
• void planeModeChanged ( bool enabled )
• void profileAdded ( const QPhoneProfile & profile )
• void profileRemoved ( const QPhoneProfile & profile )
• void profileUpdated ( const QPhoneProfile & profile )

• 1 signal inherited from QObject

Additional Inherited Members

• 1 property inherited from QObject
• 1 public slot inherited from QObject
• 1 public type inherited from QObject
• 4 static public members inherited from QObject
• 7 protected functions inherited from QObject
• 2 protected variables inherited from QObject

Detailed Description

The QPhoneProfileManager class allows applications to control phone profiles.

The Qt Extended 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.