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.
