1 /*

     2 * Copyright (c) 2008 Nokia Corporation and/or its subsidiary(-ies). 

     3 * All rights reserved.

     4 * This component and the accompanying materials are made available

     5 * under the terms of "Eclipse Public License v1.0"

     6 * which accompanies this distribution, and is available

     7 * at the URL "http://www.eclipse.org/legal/epl-v10.html".

     8 *

     9 * Initial Contributors:

    10 * Nokia Corporation - initial contribution.

    11 *

    12 * Contributors:

    13 *

    14 * Description:  Interface class for ui customization.

    15 *

    16 */

    17 

    18 #ifndef MPHONECUSTOMIZATION_H

    19 #define MPHONECUSTOMIZATION_H

    20 

    21 class CEikMenuBar;

    22 class CEikMenuPane;

    23 class TPhoneCmdParamCallHeaderData;

    24 

    25 

    26 // CLASS DECLARATION

    27 /**

    28 *  Interface class for ui customization.

    29 */

    30 class MPhoneCustomization

    31     {

    32 public:

    33     /**

    34     * Customizes menu bar.

    35     * @param aResuorceId Menu bar resource id

    36     * @param aMenuBar Menu bar.

    37     */

    38     virtual void CustomizeMenuBarL( TInt aResourceId, 

    39                                     CEikMenuBar* aMenuBar) = 0;

    40     

    41     /**

    42     * Customizes menu pane.

    43     * @param aResuorceId Menu pane resource id

    44     * @param aMenuPane Menu pane.

    45     */

    46     virtual void CustomizeMenuPaneL( TInt aResourceId, 

    47                                      CEikMenuPane* aMenuPane) = 0;

    48 

    49     /**

    50     * Handles custom menu commands.

    51     * @param aCommand Command id.

    52     * @return ETrue if command handled.

    53     */

    54     virtual TBool HandleCommandL( TInt aCommand ) = 0;

    55 

    56     /**

    57     * Checks is alphanumeric mode allowed for number entry/

    58     * dialer.

    59     * @return ETrue if allowed.     

    60     */

    61     virtual TBool AllowAlphaNumericMode() = 0; 

    62     

    63     /**

    64     * Returns resource id for soft keys.

    65     * @return Resource id.

    66     */

    67     virtual TInt CustomizeSoftKeys() = 0;

    68     

    69     /**

    70     * Returns text resource id for private call header.

    71     * @return Resource id.

    72     */

    73     virtual TInt CustomizeCallHeaderText() = 0;

    74     

    75     /**

    76     * Customizes call header texts shown in a call bubble.

    77     * @param    aCallId             Call identifier.

    78     * @param    aHeaderData         Call header data to be modified.

    79     * @param    aInCallNumberText   In call number text (Call 1, Call 2...).

    80     */

    81     virtual void ModifyCallHeaderTexts( TInt aCallId, 

    82         TPhoneCmdParamCallHeaderData* aHeaderData,

    83         const TDesC& aInCallNumberText ) = 0;

    84     

    85     /**

    86     * Returns text resource id for busy note.

    87     * @return Resource id.

    88     */

    89     virtual TInt CustomizeBusyNoteText() = 0;

    90 

    91     /**

    92     * Handles calls from number entry.

    93     * @return ETrue when call is handled by customization.

    94     *         EFalse otherwice.

    95     */

    96     virtual TBool HandleCallFromNumberEntryL() = 0;

    97 

    98     /**

    99     * A message handling function for Phone Engine messages

   100     * @param aMessage   Id of the message 

   101     * @param aCallId    the call id of the call

   102     */

   103     virtual TBool HandlePhoneEngineMessageL(

   104         const TInt aMessage, 

   105         TInt aCallId ) = 0; 

   106         

   107     /**

   108     * Handles dial by unknown service id.

   109     * @param aNumber   Number/Address 

   110     */

   111     virtual void HandleDialL( const TDesC& aNumber ) = 0; 

   112         

   113     };

   114     

   115 #endif // MPHONECUSTOMIZATION_H

   116