Symbian^3 Product Developer Library >

CMessageIterator Class Reference

class CMessageIterator : public CBase

Message Iterator Utility Class Typically used by message editors to implement next and previous message menu options. Class is an observer of the parent of the current entry, so it does handle changes in the children list. Class does not handle other external events e.g. deletion of parent.

Inherits from

Public Member Functions
~CMessageIterator()
IMPORT_C const TMsvEntry &CurrentMessage()
IMPORT_C TIntCurrentMessageIndex()
IMPORT_C const TMsvEntry &CurrentParent()
voidHandleEntryEventL(TMsvEntryEvent, TAny *, TAny *, TAny *)
IMPORT_C TIntMessagesInFolder()
IMPORT_C CMessageIterator *NewL(CMsvSession &, const TMsvEntry &)
IMPORT_C TBoolNextMessageExists()
IMPORT_C CMsvOperation *OpenCurrentMessageL(TRequestStatus &, TBool)
IMPORT_C TBoolPreviousMessageExists()
IMPORT_C voidSetCurrentMessageL(const TMsvEntry &)
IMPORT_C voidSetMessageIteratorObserver(MMessageIteratorObserver *)
IMPORT_C TIntSetNextMessage()
IMPORT_C TIntSetPreviousMessage()
Private Member Functions
CMessageIterator()
voidConstructL(CMsvSession &, const TMsvEntry &)
voidUpdateChildrenOfParentL(TMsvId)
Inherited Functions
CBase::CBase()
CBase::Delete(CBase *)
CBase::Extension_(TUint,TAny *&,TAny *)
CBase::operator new(TUint)
CBase::operator new(TUint,TAny *)
CBase::operator new(TUint,TLeave)
CBase::operator new(TUint,TLeave,TUint)
CBase::operator new(TUint,TUint)
CBase::~CBase()
Private Attributes
CMsvEntrySelection *iChildrenOfParent
TInt iCurrentIndex
TBool iEntryObserver
MMessageIteratorObserver *iMessageIteratorObserver
CMsvEntry *iParentOfCurrent

Constructor & Destructor Documentation

CMessageIterator()

CMessageIterator()[private]

C++ constuctor

~CMessageIterator()

IMPORT_C~CMessageIterator()

Destructor

Member Functions Documentation

ConstructL(CMsvSession &, const TMsvEntry &)

voidConstructL(CMsvSession &aSession,
const TMsvEntry &aStartMessage
)[private]

Symbian OS constructor

Parameters

CMsvSession & aSession
const TMsvEntry & aStartMessage

CurrentMessage()

IMPORT_C const TMsvEntry &CurrentMessage()const

CurrentMessageIndex()

IMPORT_C TIntCurrentMessageIndex()const

CurrentParent()

IMPORT_C const TMsvEntry &CurrentParent()const

HandleEntryEventL(TMsvEntryEvent, TAny *, TAny *, TAny *)

voidHandleEntryEventL(TMsvEntryEventaEvent,
TAny *aArg1,
TAny *aArg2,
TAny *aArg3
)

From MMsvEntryObserver

Parameters

TMsvEntryEvent aEvent
TAny * aArg1
TAny * aArg2
TAny * aArg3

MessagesInFolder()

IMPORT_C TIntMessagesInFolder()const

NewL(CMsvSession &, const TMsvEntry &)

IMPORT_C CMessageIterator *NewL(CMsvSession &aSession,
const TMsvEntry &aCurrentMessage
)[static]

Two-phased constructor.

Parameters

CMsvSession & aSession
const TMsvEntry & aCurrentMessage

NextMessageExists()

IMPORT_C TBoolNextMessageExists()const

OpenCurrentMessageL(TRequestStatus &, TBool)

IMPORT_C CMsvOperation *OpenCurrentMessageL(TRequestStatus &aStatus,
TBoolaEmbed = ETrue
)

Opens current message

Parameters

TRequestStatus & aStatus
TBool aEmbed = ETrue

PreviousMessageExists()

IMPORT_C TBoolPreviousMessageExists()const

SetCurrentMessageL(const TMsvEntry &)

IMPORT_C voidSetCurrentMessageL(const TMsvEntry &aCurrentMessage)

Parameters

const TMsvEntry & aCurrentMessage

SetMessageIteratorObserver(MMessageIteratorObserver *)

IMPORT_C voidSetMessageIteratorObserver(MMessageIteratorObserver *aObserver)

Set iterator observer.

Parameters

MMessageIteratorObserver * aObserver

SetNextMessage()

IMPORT_C TIntSetNextMessage()

Changes current message to next

SetPreviousMessage()

IMPORT_C TIntSetPreviousMessage()

Changes current message to previous

UpdateChildrenOfParentL(TMsvId)

voidUpdateChildrenOfParentL(TMsvIdaCurrentMessageId)[private]

internal

Parameters

TMsvId aCurrentMessageId

Member Data Documentation

CMsvEntrySelection * iChildrenOfParent

CMsvEntrySelection *iChildrenOfParent[private]

TInt iCurrentIndex

TInt iCurrentIndex[private]

TBool iEntryObserver

TBool iEntryObserver[private]

MMessageIteratorObserver * iMessageIteratorObserver

MMessageIteratorObserver *iMessageIteratorObserver[private]

CMsvEntry * iParentOfCurrent

CMsvEntry *iParentOfCurrent[private]

Copyright ©2010 Nokia Corporation and/or its subsidiary(-ies).
All rights reserved. Unless otherwise stated, these materials are provided under the terms of the Eclipse Public License v1.0.