/*
* 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