1 /*

     2 * Copyright (c) 2005 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:  

    15 *

    16 */

    17 

    18 

    19 #ifndef VCOMMANDMERGER_H

    20 #define VCOMMANDMERGER_H

    21 

    22 //  INCLUDES

    23 #include <e32base.h>

    24 

    25 #include "vcommandapi.h"

    26 

    27 class CVCommandMerger : public CBase

    28 	{

    29 	public:

    30 		static CVCommandMerger* NewLC();

    31 		

    32 		/**

    33          * Compares the runnable component of the aTarget commands with the one of

    34          * aInjection commands. Returns the array of commands from aTarget that have counterparts

    35          * in aInjection with the equal Runnable, but with different spoken text or UI.

    36          * Difference in user texts only does not count

    37          * 

    38          * This is to detect the commands that should be removed when the system language 

    39          * is changed

    40          * 

    41          * @param aTarget Set of commands "already existing in the system".

    42          * @param aInjection Set of new commands to replace the aTarget commands with the equal

    43          *        runnables

    44          * 

    45          * @return Array of commands from aTarget that have counterparts

    46          *         in aInjection with the equal Runnable, but with different spoken text or UI.

    47 		 */

    48 		CVCommandArray* ProduceDeductionByRunnablesLC( const CVCommandArray& aTarget, 

    49 											   	       const RVCommandArray& aInjection ) const;

    50 											   

    51         /**

    52          * Compares the runnable component of the aTarget commands with the one of

    53          * aInjection commands. Returns the array of commands consisting of everything

    54          * in aInjection, without the commands fully equal to any command in aTarget

    55          * Difference in user texts only does not count

    56          * 

    57          * This is to detect the commands that should be (re)trained when the system language 

    58          * is changed

    59          * 

    60          * @param aTarget Set of commands "already existing in the system".

    61          * @param aInjection Set of new commands to replace the aTarget commands with the equal

    62          *        runnables

    63          * 

    64          * @return the array of commands consisting of everything

    65          * in aInjection, without the commands fully equal to any command in aTarget

    66          */

    67          CVCommandArray* ProduceAdditionByRunnablesLC( const CVCommandArray& aTarget, 

    68 											           const RVCommandArray& aInjection ) const;

    69 	};

    70 

    71 #endif // VCOMMANDMERGER_H

    72 

    73 // End of File