diff -r f742655b05bf -r d38647835c2e convergedconnectionhandler/cchclientapi/inc/cchuiglobalqueryhandler.h --- /dev/null Thu Jan 01 00:00:00 1970 +0000 +++ b/convergedconnectionhandler/cchclientapi/inc/cchuiglobalqueryhandler.h Wed Sep 01 12:29:57 2010 +0100 @@ -0,0 +1,149 @@ +/* +* 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: Class handling notifier plugin usage. +* +*/ + + +#ifndef C_CCHUIGLOBALQUERYHANDLER_H +#define C_CCHUIGLOBALQUERYHANDLER_H + +#include +#include +#include +#include + +#include "cchuicommon.hrh" + +class CAknSDData; + + +/** + * Global query handler. + * This class handles qlobal query usage in cchui. + * + * @code + * //Example how to show change connection query. You need to inherint class + * //that is using globalqueryhandler from CActive to get result in + * //RunL when dialog is completed. + * iGlobalQueryHandler = CCchUiGlobalQueryHandler::NewL(); + * TInt serviceId( KServiceId ); + * MCchUiObserver::TCchUiDialogType dialog = + * MCchUiObserver::ECchUiDialogTypeChangeConnection; + * iGlobalQueryHandler->ShowMsgQueryL( dialog, iStatus, serviceId ); + * SetActive(); + * @endcode + * + * @lib cchui.lib + * @since S60 5.0 + */ +NONSHARABLE_CLASS( CCchUiGlobalQueryHandler ): public CBase + { +public: + + /** + * Two-phased constructor. + */ + static CCchUiGlobalQueryHandler* NewL(); + + /** + * Two-phased constructor. + */ + static CCchUiGlobalQueryHandler* NewLC(); + + /** + * Destructor. + */ + virtual ~CCchUiGlobalQueryHandler(); + + + /** + * Shows global message query asynchronously. + * + * @since S60 5.0 + * @param aNote Note mode. + * @param aStatus Asynchronic observer iStatus. + * @param aServiceId Service id. + * @param aIapId iap id. + * @param aUserName service username. + */ + void ShowMsgQueryL( + MCchUiObserver::TCchUiDialogType aNote, + TRequestStatus& aStatus, + TUint aServiceId, + TUint aIapId, + RBuf& aUserName ); + + /** + * Update the softkeys of the message query. + * + * @since S60 5.0 + * @param aSoftkeys New resource for softkeys. + */ + void UpdateMsgQuery( TInt aSoftkeys ); + + /** + * Cancel the message query. + * + * @since S60 5.0 + */ + void CancelMsgQuery(); + + /** + * Returns result params. + * + * @since S60 5.0 + * @return Result params. + */ + TCCHUiNotifierParams ResultParams(); + + +private: + + CCchUiGlobalQueryHandler(); + + void ConstructL(); + + +private: // data + + /** + * Handle to RNotifier. + */ + RNotifier iNotify; + + /** + * Global query command. + */ + TAknGlobalQueryCmd iCmd; + + /** + * Notifier params package. + */ + TCCHUiNotifierParamsPckg iPckg; + + /** + * Contains resource id for softkeys. + */ + TInt iSoftkeys; + + /** + * State of iNotify + */ + TBool iNotifyStarted; + + CCHUI_UNIT_TEST( UT_CchUi ) + }; + +#endif // C_CCHUIGLOBALQUERYHANDLER_H