/*
* Copyright (c) 2007-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:  
*
*/



#ifndef C_HNMDACTION_H
#define C_HNMDACTION_H

#include <e32base.h>
#include <xmlengdom.h>

class CLiwGenericParamList;
class CLiwDefaultMap;
class TLiwVariant;
class CHnMdBaseKey;
class CHnMdServiceCommand;
class CHnActionModel;
class CHnMdService;
class CHnConditionInterface;

/**
 * Action.
 * 
 * This is the class that represents the action. Actions are used
 * to invoke different functions or methods from services, plugins
 * or internally defined in the Matrix Menu.
 *
 * @lib hnmetadatamodel
 * @since S60 v5.0
 * @ingroup group_hnmetadatamodel
 */
NONSHARABLE_CLASS(CHnMdAction) : public CBase
    {
public:

    /**
     * Standard factory method.
     *
     * since S60 v5.0
     * @param aElement Xml element.
     * @return Fully constructed object.
     */
    static CHnMdAction* NewL( TXmlEngElement aElement );

    /**
     * Standard factory method.
     *
     * since S60 v5.0
     * @param aElement Xml element.
     * @return Fully constructed object.
     */
    static CHnMdAction* NewLC( TXmlEngElement aElement );

    /**
     * standard destructor
     */
    virtual ~CHnMdAction();
      
    /**
     * Evaluates action model based on the instance of meta data action.
     *
     * @since S60 5.0
     * @param aActionModel Visual model af an action.
     * @param aQueriesResultsList Query results.
     * @param aPos Position in the query.
     * @return Error code.
     */    
    TInt EvaluateL( CHnActionModel* aActionModel,
            const CLiwGenericParamList& aQueriesResultsList, 
            TInt aPos = 0);
    /**
     * Checks if the menu item is valid.
     *
     * @since S60 5.0
     * @param aQueryResults Query results in the form of the CLiwGenericParamList object.
     * @param aPos Position in the query.
     * @return True if valid, otherwise false.
     */
    TBool IsValidL( const CLiwGenericParamList& aQueryResults, 
            TInt aPos = 0 );
    
private:

    /**
     * Default constructor.
     */
    CHnMdAction();

    /**
     * EPOC default constructor for performing 2nd stage construction.
     * 
     * @param aElement Xml element.
     */
    void ConstructL( TXmlEngElement aElement );
  
    /**
     * Sets interface.
     * @param aAttr Xml attribute.
     */  
    void SetConditionL( TXmlEngAttr aAttr );
  
    
private: // data

    /**
     * Own - Condition.
     */
    CHnConditionInterface* iCondition;
     
    /**
     * Own.
     */
    CHnMdService* iService;

    };

#endif // C_HNMMACTION_H