MPresenceBlockListEvent Class Reference

class MPresenceBlockListEvent : public MXIMPBase

Event interface for presence block list content.

This interface is implemented by the XIMP Framework and event object is signalled to registered client observers through MXIMPContextObserver observer interface. This event notifies clients about changes in presence block list content.

Clients subscribe for this event with MPresenceAuthorization::SubscribePresenceBlockListL .

XIMP Framework signals this event when:
  • New subscribed data is received from protocol.

  • Data item data subscription status is updated by protocol adaptation.

  • When client unsubscribes the data item.

  • XIMP Framework generates initial data notification to client automatically after clients subscription, when the initial data comes available from protocol.

Since
S60 v3.2

Inherits from

Constructor & Destructor Documentation

~MPresenceBlockListEvent()

~MPresenceBlockListEvent ( ) [protected, inline, virtual]

Protected destructor. Object instancies can't be deleted via this interface.

Member Functions Documentation

CurrentBlock(TInt)

const MPresenceBlockInfo & CurrentBlock ( TInt aIndex ) const [pure virtual]

Gets presence block entry by index.

Note that, valid "current information" is signalled only when the client refreshes the event data from XIMP Framework cache, by re-issuing the data subscription. In other cases, just plain "delta information" is signalled to client.

Parameters

TInt aIndex The index of the presence block entry to get.

CurrentBlocksCount()

TInt CurrentBlocksCount ( ) const [pure virtual]

Gets count of current presence block entries.

Note that, valid "current information" is signalled only when the client refreshes the event data from XIMP Framework cache, by re-issuing the data subscription. In other cases, just plain "delta information" is signalled to client.

DataSubscriptionState()

const MXIMPDataSubscriptionState & DataSubscriptionState ( ) const [pure virtual]

Returns subscription state object holding information data items data subscription state.

DisappearedBlock(TInt)

const MPresenceBlockInfo & DisappearedBlock ( TInt aIndex ) const [pure virtual]

Gets presence block entry by index.

Parameters

TInt aIndex The index of the presence block entry to get.

DisappearedBlocksCount()

TInt DisappearedBlocksCount ( ) const [pure virtual]

Gets count of disappeared presence block entries.

NewBlock(TInt)

const MPresenceBlockInfo & NewBlock ( TInt aIndex ) const [pure virtual]

Gets presence block entry by index.

Parameters

TInt aIndex The index of the presence block entry to get.

NewBlocksCount()

TInt NewBlocksCount ( ) const [pure virtual]

Gets count of new presence block entries.

UpdatedBlock(TInt)

const MPresenceBlockInfo & UpdatedBlock ( TInt aIndex ) const [pure virtual]

Gets presence block entry by index.

Parameters

TInt aIndex The index of the presence block entry to get.

UpdatedBlocksCount()

TInt UpdatedBlocksCount ( ) const [pure virtual]

Gets count of updated presence block entries.