Collapse all Symbian^3 Product Developer Library

MProEngProfile Class Reference

class MProEngProfile

Profile settings interface. MProEngProfile offers methods to get the alert for items, profile settings and profile name interface. How to use:

  // Get active profile with MProEngEngine::ActiveProfileL().
  MProEngProfile* profile = iProfileEngine->ActiveProfileL();

  // Use profile object here...

  // When you are ready, free resources with MProEngProfile::Release()
  profile->Release();

  // If you release resources in destructor then:
  if( iProfile )
      {
      iProfile->Release();
      }

  // If you put this class to CleanupStack then use void CleanupReleasePushL()
  CleanupReleasePushL( *profile );

ProfileEngine.lib

Since: 3.1

Public Member Functions
const TArray< TContactItemId >	AlertForL()
void	CommitChangeL()
TBool	IsSilent()
MProEngProfileName &	ProfileName()
MProEngTones &	ProfileTones()
void	Release()
TInt	SetAlertForL(const TArray< TContactItemId > &)
MProEngToneSettings &	ToneSettings()

Protected Member Functions
	~MProEngProfile()

Private Member Functions
MProEngProfileExt *	Extension()

Constructor & Destructor Documentation

~MProEngProfile()

~MProEngProfile

(

)

[protected, inline, virtual]

Member Functions Documentation

AlertForL()

const TArray< TContactItemId >

AlertForL

(

)

[pure virtual]

Return the alert for item array. Only the calls coming from people who belong to one or more "Alert for" groups returned here trigger an audible alert.

Since: 3.1

CommitChangeL()

void

CommitChangeL

(

)

[pure virtual]

Store profile settings. Leaves with: KErrAccessDenied if one or more of the settings of this profile is/are read-only, KErrAlreadyExists if the profile name has been changed and there already is a profile with the same name, KErrNotFound if a file set as an alert tone cannot be found, KErrNotSupported if the MIME type of a file set as an alert tone is not supported to be used as an alert tone, KErrArgument if a file set as an alert tone is DRM-protected but the platform does not allow the files of this MIME type to be set as alert tones when protected, KErrPermissionDenied, if a file set as an alert tone is not DRM-protected and the platform does not allow the files of this MIME type to be set as alert tones when unprotected, KErrCancel, if a file set as an alert tone is an unactivated DRM file and user does not want to activate it, KErrTooBig if the tone file set for ringing tone (line 1 or line 2) is too big in case the platform has this kind of limitation set, another system-wide error code.

Only processes with WriteDeviceData capability can succesfully call this method.

Since: 3.1

Extension()

MProEngProfileExt *

Extension

(

)

[private, inline, virtual]

This member is internal and not intended for use.

IsSilent()

TBool

IsSilent

(

)

const [pure virtual]

Return whether this profile is silent. A profile being silent means that either the ringing type is silent or all the alert tones are set to "None".

Since: 3.1

ProfileName()

MProEngProfileName &

ProfileName

(

)

const [pure virtual]

Return profile name interface.

Since: 3.1

ProfileTones()

MProEngTones &

ProfileTones

(

)

const [pure virtual]

Return profile tones interface.

Since: 3.1

Release()

void

Release

(

)

[pure virtual]

Free resources of the profile.

Since: 3.1

SetAlertForL(const TArray< TContactItemId > &)

TInt

SetAlertForL

(

const TArray< TContactItemId > &

aAlertFor

)

[pure virtual]

This method set alert for items to the profile. Only the calls coming from people who belong to one or more "Alert for" groups set here trigger an audible alert.

Since: 3.1

Parameters

const TArray< TContactItemId > & aAlertFor

Alert for array. If the length of this array is 0, it is interpreted: "alert for all calls".

ToneSettings()

MProEngToneSettings &

ToneSettings

(

)

const [pure virtual]

Returns tone settings of this profile.

Since: 3.1