phoneapp/phoneuicontrol/inc/cphonestate.h
changeset 56 5bcb308bd24d
parent 45 6b911d05207e
child 65 2a5d4ab426d3
equal deleted inserted replaced
46:bc5a64e5bc3c 56:5bcb308bd24d
   119         IMPORT_C virtual void HandleKeyPressDurationL(
   119         IMPORT_C virtual void HandleKeyPressDurationL(
   120             TKeyCode aCode,
   120             TKeyCode aCode,
   121             TTimeIntervalMicroSeconds aKeyPressDuration );
   121             TTimeIntervalMicroSeconds aKeyPressDuration );
   122 
   122 
   123         /**
   123         /**
   124         * From CAknAppUi, initialise a menupane (dynamic).
       
   125         *
       
   126         * @param aResourceId It is the resource id for the pane.
       
   127         * @param aMenuPane It is the menu pane corresponding to the resource.
       
   128         */
       
   129         IMPORT_C virtual void DynInitMenuPaneL(
       
   130             TInt aResourceId,
       
   131             CEikMenuPane* aMenuPane );
       
   132 
       
   133         /**
       
   134         * From CAknAppUi, initialise a menubar (dynamic).
       
   135         *
       
   136         * @param aResourceId It is the resource id for the bar.
       
   137         * @param aMenuBar It is the menu bar corresponding to the resource.
       
   138         */
       
   139         IMPORT_C virtual void DynInitMenuBarL(
       
   140             TInt aResourceId,
       
   141             CEikMenuBar* aMenuBar );
       
   142 
       
   143         /**
       
   144         * From CEikAppUi. For Idle indicator
   124         * From CEikAppUi. For Idle indicator
   145         */
   125         */
   146         IMPORT_C virtual void HandleSystemEventL(
   126         IMPORT_C virtual void HandleSystemEventL(
   147             const TWsEvent& aEvent );
   127             const TWsEvent& aEvent );
   148 
   128 
   243         * Handles Long hash key press
   223         * Handles Long hash key press
   244         */
   224         */
   245         IMPORT_C void HandleLongHashL();
   225         IMPORT_C void HandleLongHashL();
   246 
   226 
   247         /**
   227         /**
   248         * Informs view to start Transition effect
       
   249         * @param aType a transition effect, default none
       
   250         * EndTransEffect() must be called when update is done.
       
   251         */
       
   252         IMPORT_C void BeginTransEffectLC( TStateTransEffectType aType = ENoneType );
       
   253 
       
   254         /**
       
   255         * Informs view to complete Transition effect
       
   256         */
       
   257         IMPORT_C void EndTransEffect();
       
   258 
       
   259         /**
       
   260         * Checks whether customized dialer view is active,
   228         * Checks whether customized dialer view is active,
   261         * @return ETrue if customized dialer is active
   229         * @return ETrue if customized dialer is active
   262         */
   230         */
   263         IMPORT_C TBool IsCustomizedDialerVisibleL() const;
   231         IMPORT_C TBool IsCustomizedDialerVisibleL() const;
   264 
       
   265         /**
       
   266         * Closes customized dialer view
       
   267         */
       
   268         IMPORT_C void CloseCustomizedDialerL();
       
   269 
   232 
   270         /**
   233         /**
   271          * Plays DTMF tone for key event
   234          * Plays DTMF tone for key event
   272          * */
   235          * */
   273         IMPORT_C void HandleDtmfKeyToneL( const TKeyEvent& aKeyEvent,
   236         IMPORT_C void HandleDtmfKeyToneL( const TKeyEvent& aKeyEvent,
   350         * @return boolean value indicating that note, query or
   313         * @return boolean value indicating that note, query or
   351         * blocking dialog is visible
   314         * blocking dialog is visible
   352         */
   315         */
   353         IMPORT_C TBool IsAnyQueryActiveL();
   316         IMPORT_C TBool IsAnyQueryActiveL();
   354 
   317 
   355         /**
       
   356         * Check if menu bar is visible
       
   357         * @return boolean value indicating that menu bar is visible
       
   358         */
       
   359         IMPORT_C TBool IsMenuBarVisibleL() const;
       
   360 
       
   361         /**
       
   362          * Sets context menu to correspond the incall options menu
       
   363          *
       
   364          */
       
   365         IMPORT_C virtual void UpdateInCallContextMenuL();
       
   366 
       
   367         /*
   318         /*
   368         * If KFeatureIdFfSimlessOfflineSupport is undefined and
   319         * If KFeatureIdFfSimlessOfflineSupport is undefined and
   369         * UI shows note which will be closed by key event then
   320         * UI shows note which will be closed by key event then
   370         * method return ETrue otherwise EFalse.
   321         * method return ETrue otherwise EFalse.
   371         */
   322         */
   373 
   324 
   374         IMPORT_C void RetainPreviousKeylockStateL();
   325         IMPORT_C void RetainPreviousKeylockStateL();
   375         
   326         
   376     public: // NumberEntry functions.
   327     public: // NumberEntry functions.
   377 
   328 
   378         /**
       
   379         * Passes create number entry command forward if NE can be created.
       
   380         */
       
   381         IMPORT_C virtual void HandleCreateNumberEntryL(
       
   382                 const TKeyEvent& aKeyEvent,
       
   383                 TEventCode aEventCode );
       
   384         /**
   329         /**
   385         * Check if number entry is used
   330         * Check if number entry is used
   386         * @return boolean value indicating that number entry is used
   331         * @return boolean value indicating that number entry is used
   387         */
   332         */
   388         IMPORT_C virtual TBool IsNumberEntryUsedL();
   333         IMPORT_C virtual TBool IsNumberEntryUsedL();
   487         * Return remote info data
   432         * Return remote info data
   488         * @param aCallid call id
   433         * @param aCallid call id
   489         * @param aData the returned remote info data
   434         * @param aData the returned remote info data
   490         */
   435         */
   491         IMPORT_C void GetRemoteInfoDataL( TInt aCallId, TDes& aData );
   436         IMPORT_C void GetRemoteInfoDataL( TInt aCallId, TDes& aData );
   492 
       
   493         /**
       
   494          * Sets context menu
       
   495          *
       
   496          * @param aResourceId   resource
       
   497          */
       
   498         IMPORT_C virtual void SetContextMenuL( TInt aResourceId );
       
   499 
       
   500         /**
       
   501          * Sets context menu to correspond the incoming options menu
       
   502          *
       
   503          * @param aCallId   incoming call id
       
   504          */
       
   505         IMPORT_C virtual void UpdateIncomingContextMenuL( TInt aCallId );
       
   506 
       
   507 
   437 
   508         /**
   438         /**
   509         * Show note
   439         * Show note
   510         * @param aResourceId resource id to be resolved
   440         * @param aResourceId resource id to be resolved
   511         */
   441         */
   531             TInt aContentCbaResourceId,
   461             TInt aContentCbaResourceId,
   532             TDes* aDataText,
   462             TDes* aDataText,
   533             TBool aSendKeyEnabled = EFalse );
   463             TBool aSendKeyEnabled = EFalse );
   534 
   464 
   535         /**
   465         /**
   536         * Check if note is visible
       
   537         * @return boolean value indicating that note is visible
       
   538         */
       
   539         IMPORT_C TBool IsNoteVisibleL();
       
   540 
       
   541         /**
       
   542         * Handle numeric key event
   466         * Handle numeric key event
   543         */
   467         */
   544         IMPORT_C virtual void HandleNumericKeyEventL(
   468         IMPORT_C virtual void HandleNumericKeyEventL(
   545             const TKeyEvent& aKeyEvent,
   469             const TKeyEvent& aKeyEvent,
   546             TEventCode aEventCode );
   470             TEventCode aEventCode );
   684         * @param touchpane resource id.
   608         * @param touchpane resource id.
   685         */
   609         */
   686         IMPORT_C void SetTouchPaneButtons( TInt aResourceId );
   610         IMPORT_C void SetTouchPaneButtons( TInt aResourceId );
   687 
   611 
   688         /*
   612         /*
   689         * Sets touchpane visibility.
       
   690         *
       
   691         * @param ETrue if visible otherwise EFalse.
       
   692         */
       
   693         IMPORT_C void SetTouchPaneVisible( TBool aVisible );
       
   694 
       
   695         /*
       
   696         * Destroys touchpane buttons.
   613         * Destroys touchpane buttons.
   697         */
   614         */
   698         IMPORT_C void DeleteTouchPaneButtons();
   615         IMPORT_C void DeleteTouchPaneButtons();
   699 
       
   700         /*
       
   701         * Enables touchpane button that holds given command id.
       
   702         *
       
   703         * @param aCommandId Command id.
       
   704         */
       
   705         IMPORT_C void SetTouchPaneButtonEnabled( TInt aCommandId );
       
   706 
       
   707         /*
       
   708         * Disables touchpane button that holds given command id.
       
   709         *
       
   710         * @param aCommandId Command id.
       
   711         */
       
   712         IMPORT_C void SetTouchPaneButtonDisabled( TInt aCommandId );
       
   713 
       
   714         /*
       
   715         * Checks if DTMF editor is active,
       
   716         * @return true is DTMF is active
       
   717         */
       
   718         IMPORT_C TBool IsDTMFEditorVisibleL() const;
       
   719 
       
   720         /**
       
   721         * Closes dtmf editor.
       
   722         */
       
   723         IMPORT_C void CloseDTMFEditorL();
       
   724 
   616 
   725         /**
   617         /**
   726         * Set default flags values.
   618         * Set default flags values.
   727         * No active call
   619         * No active call
   728         */
   620         */
   743         /**
   635         /**
   744         * A message handling function for message EPEMessageDisconnecting
   636         * A message handling function for message EPEMessageDisconnecting
   745         * @param aCallId: the call id of the call
   637         * @param aCallId: the call id of the call
   746         */
   638         */
   747         IMPORT_C void HandleDisconnectingL( TInt aCallId );
   639         IMPORT_C void HandleDisconnectingL( TInt aCallId );
   748 
       
   749         /**
       
   750         * Returns customized dialer menu resource id
       
   751         */
       
   752         IMPORT_C TInt CustomizedDialerMenuResourceIdL();
       
   753 
       
   754         /**
       
   755         * Returns customized dialer CBA resource id
       
   756         */
       
   757         IMPORT_C TInt CustomizedDialerCbaResourceIdL();
       
   758         
   640         
   759         /**
   641         /**
   760         * Opens soft reject message editor.
   642         * Opens soft reject message editor.
   761         */
   643         */
   762         IMPORT_C virtual void OpenSoftRejectMessageEditorL();
   644         IMPORT_C virtual void OpenSoftRejectMessageEditorL();
   795         * Stores the number entry content to the cache
   677         * Stores the number entry content to the cache
   796         */
   678         */
   797         IMPORT_C void StoreNumberEntryContentL();
   679         IMPORT_C void StoreNumberEntryContentL();
   798 
   680 
   799         /**
   681         /**
   800         * Restores the number entry content from the cache
       
   801         */
       
   802         IMPORT_C void RestoreNumberEntryContentL();
       
   803 
       
   804         /**
       
   805         * Clears the number entry content cache
   682         * Clears the number entry content cache
   806         */
   683         */
   807         IMPORT_C void ClearNumberEntryContentCache();
   684         IMPORT_C void ClearNumberEntryContentCache();
   808 
   685 
   809         /**
   686         /**
   813 
   690 
   814         /**
   691         /**
   815          * Checks if on screen dialer feature is supported.
   692          * Checks if on screen dialer feature is supported.
   816          */
   693          */
   817         IMPORT_C TBool IsOnScreenDialerSupported() const;
   694         IMPORT_C TBool IsOnScreenDialerSupported() const;
   818 
       
   819         /**
       
   820         * Informs phoneengine that phone number has been edited i.e. phonenumber parser is run
       
   821         */
       
   822         IMPORT_C virtual  void HandleNumberEntryEdited();
       
   823 
   695 
   824         /**
   696         /**
   825          * Returns ETrue if alphanumeric characters are supported.
   697          * Returns ETrue if alphanumeric characters are supported.
   826          * @param aKeyEvent Key event.
   698          * @param aKeyEvent Key event.
   827          * @return ETrue if alphanumeric chars are supported.
   699          * @return ETrue if alphanumeric chars are supported.
   836 
   708 
   837          /**
   709          /**
   838          * Internal number entry handling methods.
   710          * Internal number entry handling methods.
   839          */
   711          */
   840          void NumberEntryClearL();
   712          void NumberEntryClearL();
   841          
       
   842           
       
   843          /**
       
   844          * Dims silence touch button if call is not alerting.
       
   845          * @param None
       
   846          */
       
   847          IMPORT_C void UpdateSilenceButtonDimming();
       
   848 
       
   849          /**
       
   850          * Sets toolbar dimming.
       
   851          * @param aDimmed ETrue if dimmed
       
   852          */
       
   853          IMPORT_C void SetToolbarDimming( TBool aDimmed );
       
   854 
   713 
   855          /**
   714          /**
   856          * Sets toolbar loudspeaker button enabled.
   715          * Sets toolbar loudspeaker button enabled.
   857          */
   716          */
   858          IMPORT_C void SetToolbarButtonLoudspeakerEnabled();
   717          IMPORT_C void SetToolbarButtonLoudspeakerEnabled();
   878        * @param aCallId, call id.
   737        * @param aCallId, call id.
   879        */
   738        */
   880        TBool IsWaitingCallL( const TInt aCallId );
   739        TBool IsWaitingCallL( const TInt aCallId );
   881 
   740 
   882        /**
   741        /**
   883        * Shows dtmf dialer
       
   884        */
       
   885        void ShowDtmfDialerL();
       
   886 
       
   887        /**
       
   888        * Checks status of KFeatureIdSideVolumeKeys and KTelephonyLVFlagScrollVolumeKeys
   742        * Checks status of KFeatureIdSideVolumeKeys and KTelephonyLVFlagScrollVolumeKeys
   889        * keys. If KTelephonyLVFlagScrollVolumeKeys is false and KFeatureIdSideVolumeKeys is true
   743        * keys. If KTelephonyLVFlagScrollVolumeKeys is false and KFeatureIdSideVolumeKeys is true
   890        * then side volume keys are only supported and method returns true, otherwise false.
   744        * then side volume keys are only supported and method returns true, otherwise false.
   891        */
   745        */
   892        TBool OnlySideVolumeKeySupported();
   746        TBool OnlySideVolumeKeySupported();
   900        TBool IsAnyConnectedCalls();
   754        TBool IsAnyConnectedCalls();
   901 
   755 
   902     private:
   756     private:
   903 
   757 
   904         /**
   758         /**
   905         * Update incall indicator
       
   906         * @param aCallState a call state
       
   907         */
       
   908         void UpdateIncallIndicatorL( TInt aCallState );
       
   909 
       
   910         /**
       
   911         * Handle EPEMessageChangedCallDuration
   759         * Handle EPEMessageChangedCallDuration
   912         * @param aCallId call id of the message
   760         * @param aCallId call id of the message
   913         */
   761         */
   914         void HandleChangedCallDurationL( TInt aCallId );
   762         void HandleChangedCallDurationL( TInt aCallId );
   915 
   763 
   916         /**
   764         /**
   917         * Update profile display
   765         * Update profile display
   918         */
   766         */
   919         void UpdateProfileDisplayL();
   767         void UpdateProfileDisplayL();
   920 
       
   921         /**
       
   922         * Update operator display
       
   923         */
       
   924         void UpdateOperatorDisplayL();
       
   925 
   768 
   926         /**
   769         /**
   927         * Sends key down event to the phone engine
   770         * Sends key down event to the phone engine
   928         * @param aKeyEvent a key event
   771         * @param aKeyEvent a key event
   929         * @param aEventCode key event code
   772         * @param aEventCode key event code
   938         * @param aEventCode key event code
   781         * @param aEventCode key event code
   939         */
   782         */
   940         void SendKeyEventL(
   783         void SendKeyEventL(
   941             const TKeyEvent& aKeyEvent,
   784             const TKeyEvent& aKeyEvent,
   942             TEventCode aEventCode );
   785             TEventCode aEventCode );
   943 
       
   944         /**
       
   945         * ETrue if title pane is visible
       
   946         */
       
   947         TBool TitlePaneIsVisibleL() const;
       
   948 
   786 
   949         /**
   787         /**
   950         * Change Audio volume level
   788         * Change Audio volume level
   951         * @param aLevel New volume level.
   789         * @param aLevel New volume level.
   952         * @param aUpdateControl Set ETrue if volume ui control
   790         * @param aUpdateControl Set ETrue if volume ui control
  1021         * after BeginUiUpdate().
   859         * after BeginUiUpdate().
  1022         */
   860         */
  1023         static void UiUpdateCleanup(TAny* aThis );
   861         static void UiUpdateCleanup(TAny* aThis );
  1024 
   862 
  1025         /**
   863         /**
  1026         * TCleanupOperation to call EndTransEffect, if leave occurs
       
  1027         * after BeginTransEffect().
       
  1028         */
       
  1029         static void EffectCleanup(TAny* aThis );
       
  1030 
       
  1031         /**
       
  1032         * Gets volume level from ui control.
   864         * Gets volume level from ui control.
  1033         */
   865         */
  1034         TInt GetVolumeLevel();
   866         TInt GetVolumeLevel();
  1035 
   867 
  1036         /**
   868         /**
  1102         * @param aData - The returned data including needed text.
   934         * @param aData - The returned data including needed text.
  1103         * @param aResourceId - Resource id for text.
   935         * @param aResourceId - Resource id for text.
  1104         */
   936         */
  1105         void LoadResource( TDes& aData, const TInt aResource ) const;
   937         void LoadResource( TDes& aData, const TInt aResource ) const;
  1106 
   938 
  1107         /**
       
  1108         * Opens virtual keyboard.
       
  1109         */
       
  1110         void OpenVkbL();
       
  1111 
       
  1112     private: // NumberEntry functions.
       
  1113 
       
  1114         /**
       
  1115         * Handles key events in situations when there exists a number entry.
       
  1116         * In this case number entry may be visible or hidden.
       
  1117         * @param aKeyEvent - key event
       
  1118         * @param aEventCode - event code
       
  1119         */
       
  1120         void KeyEventForExistingNumberEntryL(
       
  1121             const TKeyEvent& aKeyEvent,
       
  1122             TEventCode aEventCode );
       
  1123 
   939 
  1124     protected:  // Data
   940     protected:  // Data
  1125 
   941 
  1126         /**
   942         /**
  1127         * Reference to State machine
   943         * Reference to State machine