fep/aknfep/inc/aknfepuiinputminiqwertystrokephrasebase.h
author Simon Howkins <simonh@symbian.org>
Mon, 15 Nov 2010 14:00:51 +0000
branchRCL_3
changeset 59 7febbd162ded
parent 0 eb1f2e154e89
permissions -rw-r--r--
Removed unnecessary #ifdef guards around an inclusion - the included file has them anyway.

/*
* Copyright (c) 2008 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:           
*      Provides the TAknFepInputMiniQwertyStrokePhraseBase definition.
*
*/












#ifndef T_AKNFEPUIINPUTMINIQWERTYSTROKEPHRASEBASE_H
#define T_AKNFEPUIINPUTMINIQWERTYSTROKEPHRASEBASE_H

//#include "AknFepUiInputStateChineseBase.h"
#include "AknFepUiInputStateCandidateQwertyBaseChinesePhrase.h"

/**
 * key struct.
 * @since S60 v3.2.3
 */

class TAknFepInputMiniQwertyStrokePhraseBase : public TAknFepInputStateCandidateQwertyBaseChinesePhrase
    {
public:
    /**
     * change state flag.
     */
    enum TAknFepStrokePhraseChange
        {
        EManualChangeState,
        EAutoChangeStateFromInput,
        EAutoChangeStateFromCandidate
        };
    
    /**
     * C++ default constructor
     *
     * @since S60 v3.2.3
     * @param aOwner Pointer to UI manager state interface
     * @param aUIContainer Pointer to Chinese UI container
     */
    TAknFepInputMiniQwertyStrokePhraseBase(
        MAknFepUIManagerStateInterface* aOwner,
        MAknFepUICtrlContainerChinese* aUIContainer
        );
    
    /**
     * Handle system key press event
     *
     * @since S60 v3.2.3
     * @param aKey System key
     * @param aLength Key press length
     * @return ETrue if handle, otherwise this class do not handle this key
     */
    TBool HandleKeyL( TInt aKey, TKeyPressLength aLength );
    
    /**
     * Update input window
     *
     * @since S60 v3.2.3
     * @param aRefresh, if ETRue need to get the screen position, other need not.      
     * @return None
     */
    void RefreshUI();
    
    /**
     * check the first group stroke of keystroke.
     *
     * @since S60 v3.2.3
     * @return ETrue if the first group stroke is valid, others return EFalse.
     */
    TBool CheckFirstGroupStroke();

    /**
     * Add phrase to the UDB.
     * 
     * @param aPhraseAdd that need to be added to the UDB.
     * @since S60 v3.2.3.
     * @return None.
     */ 
    void AddPhraseToDB( const TDesC& aPhraseAdd );    

    
    /**
     * Refresh candidate
     *
     * @since S60 v3.2.3
     * @return none
     */
    void RefreshCandidate();
    
    /**
     * Check key whether need repeat.
     * 
     * @since S60 v3.2.3
     * @return ETrue if the key need repeat, EFalse others.
     */
    TBool CheckKeyNeedRepeat( TKeyPressLength aLength );
    
    /**
     * Commint text to EEP or editor
     *
     * @since S60 V3.2.3
     * @param aDes Text had been select from candidate pane
     * @return ETrue if keep state, otherwise need to change to pridictive or editor
     */
    TBool CommitInlineEEPL( const TDesC& aDes );
    
    /**
     * Update indicator
     *
     * @since S60 v3.2.3
     * @return None.
     */
    void UpdateIndicator();
    
    /**
      * Do action afer commit, change state to predictive or not.
      *
      * @since S60 v3.2.3
      * @return None.
      */
    void DoActionAfterCommit();
    
    /**
     * Handling Command events.
     * This Method is called by CAknFepUIManagerJapanese.
     *
     * @param aCommandId Command ID value
     */
    void HandleCommandL( TInt aCommandId );
private:
    
    /**
     * Handle key from candidate.
     *
     * @since S60 v3.2.3
     * @param aKey System key
     * @param aLength Key press length
     * return None
     */
    void HandleKeyFromCandidateL(TInt aKey, TKeyPressLength aLength );
    
    /**
     * Handle CBA1 or select event.
     * 
     * @since S60 v3.2.3
     * @return None.
     */
    void HandleCommitL( TKeyPressLength aLength );
    
    /**
     * Auto change state.
     * 
     * @since S60 v3.2.3
     * @return Etru auto change state,ohters don't change state.
     */
    TBool HandleAutoChangeState();
    
    /**
     * Handle KeyBackspace event.
     * 
     * @param aLength Key press length
     * @since S60 v3.2.3
     * @return ETrue if handle, otherwise this class do not handle this key
     */
    void HandleKeyBackspaceL( TKeyPressLength aLength );
    
    /**
     * Handle default event.
     *
     * @since S60 v3.2.3
     * @param aKey System key
     * @param aLength Key press length
     * @return ETrue if handle, otherwise this class do not handle this key
     */
    TBool HandleDefaultL( TInt aKey, TKeyPressLength aLength );
    
    /**
     * Handle default key press event.
     *
     * @since S60 v3.2.3
     * @param aKey System key
     * @return none.
     */
    void HandleDefaultKeyL( TInt aKey );
    
    /**
     * Show the showinfo on the EEP ctrl.
     * 
     * @since S60 v3.2.3.
     * @return None.
     */
    void ShowInfoOnEEPPane();
    
    /**
     * Show the showinfo on the candidate ctrl.
     * 
     * @since S60 v3.2.3.
     * @return None.
     */
    void ShowInfoOnCandidatePane();
    
    /**
     * Handle horizontal navigation.
     * 
     * @param aKey the input keystroke.
     * @since S60 v3.2.3.
     * @return ETrue if high light can move, EFase others.
     */ 
    TBool HandleHorizontalNavigation( TInt aKey );
    
    /**
     * Add keystroke.
     * 
     * @param aKey the input keystroke.
     * @since S60 v3.2.3.
     * @return ETrue if that the key can add to the current keystroke, EFase others.
     */            
    TBool AddKeystrokeL( TInt aKey );
    
    /**
     * Get the candidate info.
     * 
     * @since S60 v3.2.3.
     * @return none.
     */            
    void GetCandidateL();
    
    /**
     * Change CBA.
     *
     * @since S60 v3.2.3
     * @return None.
     */        
    void ChangeCbaL();
    
    /**
     * Delete current keystroke.
     * 
     * @since S60 v3.2.3.
     * @return ETrue if that can be deleted, EFase others.
     */            
    TBool DeleteKeystroke();
    
    /**
     * Clear Keystroke of PtiEngine.
     *
     * @since S60 v3.2.3
     * @return None.
     */
    void ClearPtiEngineKeystroke();
    
    /**
     * get the show keystroke.
     * 
     * @param aKey, the input keystroke.
     * @param aKeystroke the show keystroke.
     * @since S60 v3.2.3.
     * @return None.
     */
    void GetShowKeystroke( TInt aKey, TDes& aKeystroke );    
    
    /**
     * Revert the phrase to keystroke.
     * @since S60 v3.2.3
     * @return none.
     */
    void RevertPhraseToKeystrokeL();
    
    /**
     * set warning color.
     * 
     * @since S60 v3.2.3.
     * @return none.
     */         
    void SetWarningColor();
    
    /**
     * Move the cursor to Left.
     * 
     * @since S60 v3.2.3.
     * @return ETrue if cursor can be moved, other EFalse.
     */         
    TBool MoveCursorLeft();
    
    /**
     * Move the cursor to Right.
     * 
     * @since S60 v3.2.3.
     * @return ETrue if cursor can be moved, other EFalse.
     */         
    TBool MoveCursorRight();

    /**
     * check the all group stroke of keystroke.
     *
     * @since S60 v3.2.3
     * @return ETrue if the first group stroke is valid, others return EFalse.
     */
    TBool CheckAllGroupStroke();
    
    /**
      * Do action afer commit, change state to predictive or not.
      *
      * @since S60 v3.2.3
      * @return None.
      */
    void DoActionAfterCommitL();
    
    /**
     * check the delimeter 
     * @ aKeystroke   the key stroke
     * @@since S60 v3.2.3
     * @return ETrue if the key stoke is the delimeter ,otherwise return EFalse .
     */
   TBool CheckSpellingDLT( const TDesC& aKeystroke );

    };		

#endif //T_AKNFEPUIINPUTMINIQWERTYSTROKEPHRASEBASE_H

// End of file