/*
* Copyright (c) 2008-2009 Nokia Corporation and/or its subsidiary(-ies).
* All rights reserved.
* This component and the accompanying materials are made available
* under the terms of "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: Main class for note handling.
*
*/
#ifndef C_CCHUINOTEHANDLER_H
#define C_CCHUINOTEHANDLER_H
#include <e32base.h>
#include <badesca.h>
#include "cchuicommon.hrh"
class CCchUiGlobalQueryHandler;
class MCchUiNoteResultObserver;
/**
* Note handler.
* Note handling for cchui.
*
* @code
* // Example how to launch change connection query.
* iNoteController = CCCHUiNoteHandler::NewL( *this );
* TInt serviceId( KServiceId );
* MCchUiObserver::TCchUiDialogType dialog =
* MCchUiObserver::ECchUiDialogTypeChangeConnection;
* iNoteController->LaunchNoteL( dialog, serviceId );
* @endcode
*
* @lib cchui.lib
* @since S60 5.0
*/
NONSHARABLE_CLASS( CCCHUiNoteHandler ): public CActive
{
public:
/**
* Two-phased constructor.
*
* @param aObserver Reference to note result observer.
*/
static CCCHUiNoteHandler* NewL(
MCchUiNoteResultObserver& aObserver );
/**
* Destructor.
*/
virtual ~CCCHUiNoteHandler();
/**
* Launch note.
*
* @since S60 5.0
* @param aNote Note type.
* @param aServiceId Service id.
* @param aIapId iap id.
* @param aUsername service username.
*/
void LaunchNoteL(
MCchUiObserver::TCchUiDialogType aNote,
TUint aServiceId,
TUint aIapId,
RBuf& aUserName );
/**
* Check if there is active note.
*
* @since S60 5.0
* @retun ETrue if there is active note
*/
TBool ActiveDialogExists();
/**
* Cancels querys.
*
* @since S60 5.0
*/
void CancelOldNotes();
/**
* Returns current note.
*
* @since S60 5.0
*/
MCchUiObserver::TCchUiDialogType CurrentNote();
private:
CCCHUiNoteHandler( MCchUiNoteResultObserver& aObserver );
void ConstructL();
// from base class CActive
/**
* From CActive.
* Called when asynchronous event occurs.
*/
void RunL();
/**
* From CActive.
* Called when this active object is canceled.
*/
void DoCancel();
/**
* From CActive.
* Asynchronous error.
*/
TInt RunError( TInt aError );
private: // data
/**
* Global dialog handler.
* Own.
*/
CCchUiGlobalQueryHandler* iGlobalQueryHandler;
/**
* Note result observer.
*/
MCchUiNoteResultObserver& iObserver;
/**
* Current active note.
*/
MCchUiObserver::TCchUiDialogType iCurrentNote;
CCHUI_UNIT_TEST( UT_CchUi )
};
#endif // C_CCHUINOTEHANDLER_H