syncmlfw/syncmlnotifier/inc/SyncMLTimedInputTextQuery.h
author Dremov Kirill (Nokia-D-MSW/Tampere) <kirill.dremov@nokia.com>
Thu, 17 Dec 2009 09:07:52 +0200
changeset 0 b497e44ab2fc
permissions -rw-r--r--
Revision: 200949 Kit: 200951

/*
* Copyright (c) 2007 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:  InputText query with timeout.
*
*/



#ifndef CSYNCMLTIMEDINPUTTEXTQUERY_H
#define CSYNCMLTIMEDINPUTTEXTQUERY_H

//  INCLUDES
#include <AknQueryDialog.h>
#include <SyncMLNotifierParams.h>
#include "SyncMLQueryTimer.h"

// CONSTANTS
const TInt  KSyncMLNNoAlphanumTimeout  = 0; // The query does not time out

// CLASS DECLARATION

/**
*  InputText query with timeout.
*
*  @lib SyncMLNotifier
*  @since Series 60 3.2
*/
NONSHARABLE_CLASS ( CSyncMLTimedInputTextQuery ) : public CAknTextQueryDialog,
                                                 public MSyncMLQueryTimerObserver
    {
    public:  // Constructors and destructor
        
        /**
        * Two-phased constructor.
        */
        static CSyncMLTimedInputTextQuery* NewL(
            TDes& aInputText,const TDesC& aPromptText,
            TBool& aKeypress, TInt   aTimeout = KSyncMLNNoAlphanumTimeout );
          
        CSyncMLTimedInputTextQuery(TDes& aDataText, TBool& aKeypress, TInt aTimeout = KSyncMLNNoAlphanumTimeout );
        /**
        * Destructor.
        */
        virtual ~CSyncMLTimedInputTextQuery();
        
       

    public: // Functions from base classes

        /**
        * From MSyncMLQueryTimerObserver Is called when the timer
        * runs out.
        * @since Series 60 3.0
        * @param None
        * @return None
        */
        void TimerExpired();
        
        /**
        * From CAknQueryDialog,method called when the Editor content changed
        * @since Series 60 3.0
        * @param aQueryControl,aEventType , aStatus
        * @return None
        */
        TBool HandleQueryEditorStateEventL(CAknQueryControl* aQueryControl, 
                              TQueryControlEvent aEventType, TQueryValidationStatus aStatus);
        
    protected:  // Functions from base classes
        
        /**
        * From CEikDialog Starts the dialog timer.
        * Called after the dialog is laid out.
        * @since Series 60 3.0
        * @param None
        * @return None
        */
        void PostLayoutDynInitL();

        /**
        * From CEikDialog Determines if the dialog can be closed.
        * @since Series 60 3.0
        * @param aButtonId Identifier of the button pressed.
        * @return None
        */
        TBool OkToExitL( TInt aButtonId );
        
        /** 
        * Called by OfferkeyEventL(), gives a change to dismiss the query even with 
        * keys different than Enter of Ok. 
        */ 
        TBool NeedToDismissQueryL(const TKeyEvent& aKeyEvent);
        
        /**
        * Called by NeedToDismissQueryL(), gives a change to either accept or reject
        * the query. Default implementation is to accept the query if the Left soft
        * key is displayed and reject it otherwise. Left softkey is only displayed if
        * the query has valid data into it.
        */
        void DismissQueryL();
        
    private:    // Data
        // Number of seconds before the query is timed out. 0 = no timeout.
        TInt               iTimeout;

        // Pointer to the timer instance
        CSyncMLQueryTimer*  iTimer;
    public:    
        //Detecting key press
        TBool iKeypress;
        
    };

#endif      // CSYNCMLTIMEDMESSAGEQUERY_H   
            
// End of File