examples/SFExamples/symbian_os_communications_programming_book_v2/chapter8/receivingmessages/CMessageSummaryEngine.h

// 
// Copyright (c) 2002-2009 Nokia Corporation and/or its subsidiary(-ies).
// All rights reserved.
// This component and the accompanying materials are made available
// under the terms of the License "Eclipse Public License v1.0"
// which accompanies this distribution, and is available
// at the URL "http://www.eclipse.org/legal/epl-v10.html".
// 
// Initial Contributors:
// Nokia Corporation - initial contribution.
// 
// Contributors:
// 
// Description:
// 

#ifndef _CMessageSummaryEngine_H
#define _CMessageSummaryEngine_H

#include <e32base.h>
#include <e32cons.h>

#include <msvstd.h>
#include <msvapi.h>
#include <msvids.h>

#include "CMessageSummaryGenerator.h"

class MSummaryEngineObserver
        {
public:
        virtual void Refresh() = 0;
        };

class CMessageSummaryEngine : public CActive, public MMsvSessionObserver
        {
public:

        static CMessageSummaryEngine* NewL(MSummaryEngineObserver& aObserver);

        // Start the summary operation
        void StartL();
        
        // CActive functions
        void DoCancel();
        void RunL();
        
        // From MMsvSessionObserver
        void HandleSessionEventL(TMsvSessionEvent aEvent, TAny *aArg1, TAny *aArg2, TAny *aArg3);
        
        const CMessageSummaryGenerator& SmsSummary();
        const CMessageSummaryGenerator* EmailSummary();
        
        ~CMessageSummaryEngine();
        
protected:
        CMessageSummaryEngine(MSummaryEngineObserver& aObserver);
        void ConstructL();
        TBool UpdateNextSummary();
        void CreateSummaryGeneratorsL();
        TBool FindPop3ServiceEntryL(TMsvId& aPop3MailboxId);
        
private:
        CMessageSummaryGenerator* iEmailInboxSummary; // Only support a single POP3 inbox for now, pick the first one found
        CMessageSummaryGenerator* iSmsInboxSummary;
        
        MSummaryEngineObserver& iObserver;
        
        // Symbian OS messaging classes
        CMsvSession* iMessagingSession;
        CMsvEntry* iMessagingEntry;
        
private:

        enum TSummaryEngineState
                {
                EConnectingToMessageServer,
                EScanningForSms,
                EScanningForEmail,
                ERefreshing
                };
        
        TBool iRefreshSms; // True if the SMS summaries must be updated
        TBool iRefreshEmail; // True if the Email summaries must be updated

        TSummaryEngineState iState;
        };

#endif

---