MProEngNotifyHandler Class Reference

class MProEngNotifyHandler

Profiles change notification handler. This class is used for registration to get notifications about changes in Profiles data.

ProfileEngine.lib
Since
S60 3.1

Constructor & Destructor Documentation

~MProEngNotifyHandler()

~MProEngNotifyHandler()[inline, virtual]

Destructor.

Member Functions Documentation

CancelActiveProfileNotifications()

voidCancelActiveProfileNotifications()[pure virtual]
Cancel the registration for receiving notifications about the active profile modification events.
Since
S60 3.1

CancelAll()

voidCancelAll()[pure virtual]
Cancel all the registrations for receiving notifications.
Since
Series 60 3.1

CancelProfileActivationNotifications()

voidCancelProfileActivationNotifications()[pure virtual]
Cancel the registration for receiving notifications about profile activation events.
Since
S60 3.1

CancelProfileNameArrayNotifications()

voidCancelProfileNameArrayNotifications()[pure virtual]
Cancel the registration for receiving notifications about the changes in the profile name array.
Since
S60 3.1

CancelProfileNotifications(TInt)

voidCancelProfileNotifications(TIntaProfileId)[pure virtual]
Cancel the registration for receiving notifications about the given profile modification events.
Since
S60 3.1

Parameters

TInt aProfileIdThe ID of the profile for which the client wants to cancel the receiving of modification events.

Extension()

MProEngNotifyHandlerExt *Extension()[private, inline, virtual]

This member is internal and not intended for use.

RequestActiveProfileNotificationsL(MProEngActiveProfileObserver &)

TInt RequestActiveProfileNotificationsL(MProEngActiveProfileObserver &aObserver)[pure virtual]
Request notifications of active profile modifications. The notifications are received as long as CancelActiveProfileNotifications() or CancelAll() is called. If the client wants to change the observer, he should first cancel these notifications and then re-request them with the new observer instance.
Since
S60 3.1

Parameters

MProEngActiveProfileObserver & aObserverReference to the observer to be notified in the event of active profile modification.

RequestProfileActivationNotificationsL(MProEngProfileActivationObserver &)

TInt RequestProfileActivationNotificationsL(MProEngProfileActivationObserver &aObserver)[pure virtual]
Request notifications of profile activations. The notifications are received as long as CancelProfileActivationNotifications() or CancelAll() is called. If the client wants to change the observer, he should first cancel these notifications and then re-request them with the new observer instance.
Since
S60 3.1

Parameters

MProEngProfileActivationObserver & aObserverReference to the observer to be notified in the event of profile activation.

RequestProfileNameArrayNotificationsL(MProEngProfileNameArrayObserver &)

TInt RequestProfileNameArrayNotificationsL(MProEngProfileNameArrayObserver &aObserver)[pure virtual]
Request notifications about changes in the profile name array. This includes the cases when: a new profile has been created, a profile has been deleted, the name of a profile has been changed. The notifications are received as long as CancelProfileNameArrayNotifications() or CancelAll() is called. If the client wants to change the observer, he should first cancel these notifications and then re-request them with the new observer instance.
Since
S60 3.1

Parameters

MProEngProfileNameArrayObserver & aObserverReference to the observer to be notified in the event of a profile name array modification.

RequestProfileNotificationsL(MProEngProfileObserver &, TInt)

TInt RequestProfileNotificationsL(MProEngProfileObserver &aObserver,
TIntaProfileId
)[pure virtual]
Request notifications about changes in the given profile. This is useful for cases when the client is interested about changes in a specific profile no matter if the profile is active or not. The notifications are received as long as CancelProfileNotifications() or CancelAll() is called. If the client wants to change the observer for the notifications about the same profile, he should first cancel these notifications and then re-request them with the new observer instance.
Since
S60 3.1

Parameters

MProEngProfileObserver & aObserverReference to the observer to be notified in the event of modification of the specified profile.
TInt aProfileIdthe ID of the profile the changes of which has to be notified.