/*

* Copyright (c) 2004-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:  CCFElseClause class declaration.

*

*/

#ifndef C_CFELSECLAUSE_H

#define C_CFELSECLAUSE_H

// INCLUDES

#include <e32base.h>

#include "cfclausenode.h"

// CLASS DECLARATION

/**

*   This class implements ElseIfClause XML node of CFW script in Script Engine

*   scripts.

*

*  @lib CFScriptEngine

*  @since Series 60 2.6

*/

NONSHARABLE_CLASS( CCFElseClause ): public CCFClauseNode

    {

public: // Constructors and destructor

    /**

    * Creates a CCFElseClause object

    * @param aServices is the operation services interface for nodes.

    * @param aParent parent of this node or NULL if this is a root. The

    *   ownership of the parent is not transferred.

    * @return a pointer to the created instance of CCFElseClause

    */

    static CCFElseClause* NewL( MCFOperationServices& aServices,

            CCFOperationNode* aParent );

    /**

    * Creates a CCFElseClause object

    * @param aServices is the operation services interface for nodes.

    * @param aParent parent of this node or NULL if this is a root. The

    *   ownership of the parent is not transferred.

    * @return a pointer to the created instance of CCFElseClause

    */

    static CCFElseClause* NewLC( MCFOperationServices& aServices,

            CCFOperationNode* aParent );

    /**

    * Creates and parses a CCFElseClause instance from an xml node.

    * @param aServices is the operation services interface for nodes.

    * @param aParent is the parent of this node or NULL if this is a root. The

    *   ownership of the parent is not transferred.

    * @param aNode is the node to be parsed.

    * @return a pointer to the created instance of CCFElseClause, or NULL if the

    *   node is not else clause node. May leave with any system wide error code.

    */

    static CCFElseClause* ParseL( MCFOperationServices& aServices,

            CCFOperationNode* aParent,

            CMDXMLNode& aNode );

    /**

    * Destructor.

    */

    ~CCFElseClause();

protected: // Functions from CCFClauseNode

    /**

    * Fires actions of the node.

    * @return None.

    */

    void FireActionsL();

protected: // Functions from CCFOperationNode

    /**

    * Activates this node by passing the activate call to its' child.

    * @return None.

    */

    void ActivateL();

    /**

    * Deactivates this node by passing the deactivate call to its' child.

    * @return None.

    */

    void Deactivate();

    /**

    * Asks this node to check its security (via services interface). Checks the

    * security of actions to be performed.

    * @return KErrNone if security check passed, otherwise any of the system

    *   wide error codes.

    */

    TInt CheckSecurity();

    /**

    * Called by child node, to ask the parent to re-evaluate its value, since

    * the child's value has changed.

    * @return None.

    */

    void Evaluate();

private:

    /**

    * C++ default constructor.

    */

    CCFElseClause( MCFOperationServices& aServices, CCFOperationNode* aParent );

    /**

    * By default Symbian 2nd phase constructor is private.

    */

    void ConstructL();

private: // Data

    // Else clause actions.

    RPointerArray< CCFScriptAction > iActions;

    };

#endif // C_CFELSECLAUSE_H