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: Definition of CPhMenuExtensionWrapper class.

    15 *

    16 */

    17 

    18 

    19 

    20 #ifndef C_CPHONEMENUEXTENSIONWRAPPER_H

    21 #define C_CPHONEMENUEXTENSIONWRAPPER_H

    22 

    23 #include <e32base.h>

    24 #include <telmenuextension.h>

    25 

    26 /**

    27  *  Provides container friendly interface for extension plugin handling.

    28  *    

    29  *  @lib PhoneUIVoIPExtension.dll

    30  *  @since S60 v5.1

    31  */

    32 NONSHARABLE_CLASS( CPhMenuExtensionWrapper ) : public CTelMenuExtension

    33     {

    34 

    35 public:

    36 

    37     /**

    38      * Two-phased constructor.

    39      * @param   aImplementationUid  An Ecom plugin implementation identifier.

    40      */

    41     static CPhMenuExtensionWrapper* NewL( TUid aImplementationUid );

    42 

    43     /**

    44      * Two-phased constructor.

    45      * @param   aImplementationUid  An Ecom plugin implementation identifier.

    46      */

    47     static CPhMenuExtensionWrapper* NewLC( TUid aImplementationUid );

    48 

    49     /**

    50     * Destructor.

    51     */

    52     virtual ~CPhMenuExtensionWrapper();

    53 

    54     /**

    55      * Provides comparison algorithm for CPhMenuExtensionWrapper objects using

    56      * extension plugin implementation identifier as a search key.

    57      * 

    58      * @param   aKey        A search key.

    59      * @param   aWrapper    An object to match with a key.

    60      * @since   S60 v5.1

    61      * @return  ETrue if match, EFalse otherwise.

    62      */

    63     static TBool MatchByUid( 

    64         const TUid* aKey, const CPhMenuExtensionWrapper& aWrapper );

    65     

    66     // from base class CTelMenuExtension

    67 

    68     /**

    69     * From CTelMenuExtension.

    70     * @see CTelMenuExtension.

    71     */

    72     void ModifyExtensionsCallMenuL( 

    73             const RArray<CTelMenuExtension::TCallInfo>& aCallArray,

    74             CEikMenuPane& aMenuPane );

    75 

    76     /**

    77     * From CTelMenuExtension.

    78     * @see CTelMenuExtension.

    79     */

    80     void ModifyExtensionsTouchPaneButtonsL( 

    81             const RArray<CTelMenuExtension::TCallInfo>& aCallArray,

    82             MTelTouchPaneExtension& aTouchPane );

    83     

    84     /**

    85     * From CTelMenuExtension.

    86     * @see CTelMenuExtension.

    87     */

    88     TBool HandleCommandL( TInt aCommand );

    89 

    90 private:

    91 

    92     CPhMenuExtensionWrapper() {};

    93     

    94     CPhMenuExtensionWrapper( TUid aImplementationUid );

    95 

    96     void ConstructL();

    97     

    98     /**

    99      * Creates menu extension plugin.

   100      * @since   S60 v5.1

   101      * @return A new menu extension plugin instance.

   102      */

   103     CTelMenuExtension* CreateMenuExtensionL() const;

   104     

   105     /**

   106      * Returns identifier of the wrapped extension plugin.

   107      * @since   S60 v5.1

   108      * @return Identifier of the extension plugin.

   109      */

   110     TUid Identifier() const;

   111 

   112 private: // data

   113 

   114     /**

   115      * Extension plugin identifier.

   116      */

   117     TUid iPluginUid;

   118 

   119     /**

   120      * Menu extension plugin.

   121      * Own.

   122      */

   123     CTelMenuExtension* iPlugin;

   124 

   125     };

   126 

   127 #endif // C_CPHONEMENUEXTENSIONWRAPPER_H