/*

* Copyright (c) 2006 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:  Configuration item base for configuration items.

*

*/

#ifndef CXIMPPSCCONFIGURATIONITEMBASE_H

#define CXIMPPSCCONFIGURATIONITEMBASE_H

#include <e32base.h>

#include "ximpconfigurationitem.h"

#include "ximpsubscriptionitembase.h"

/**

 * Configuration item base

 *

 * @since S60 v3.2

 */

class CXIMPConfigurationItemBase : public CXIMPSubscriptionItemBase, 

                                   public MXIMPConfigurationItem

    {

public: // Definitions

    /** 

     * Authorization status

     */

    enum TConfigurationStatus

        {

        ENotConfiguredAtAll,

        EConfiguredForOtherCtxOnly,

        EConfiguredForCtxOnly,

        EConfiguredForCtxAndOthers

        };

public: // Construction and destruction

    /**

     * Destruction

     * - Remember to inform parent about delete.

     */

    IMPORT_C virtual ~CXIMPConfigurationItemBase();

    /**

     * Construction

     */

    IMPORT_C CXIMPConfigurationItemBase( MXIMPItemParentBase& aParent );

    /**

     * Base construction. Must be called from inherited classes ConstructL

     */

    IMPORT_C void BaseConstructL();

public: // New methods

    /**

     * Authorizationstatus for context. 

     *

     *   ENotConfiguredAtAll            - Configure not done by any context.

     *   EConfiguredForOtherCtxOnly     - Configure done by others but not aContext

     *   EConfiguredForCtxOnly          - Configure done by aContext only.

     *   EConfiguredForCtxAndOthers     - Configure done by others and aContext.

     *

     * @param aContext Check authorization status for aContext.

     */

    IMPORT_C TConfigurationStatus ConfigurationStatus( MXIMPPscContext* aContext );

    /**

     * Add configurator for item.

     * @param aContext. Context to be added.

     */

    IMPORT_C void AddConfiguratorL( MXIMPPscContext* aContext );

    /**

     * Remove configurator from item

     * @param aContext. Context to be removed.

     */

    IMPORT_C void RemoveConfigurator( MXIMPPscContext* aContext );

    /** 

     * Add configurator for item.

     * @param aItem. Item to be added.

     */

    IMPORT_C void AddConfiguratorL( CXIMPConfigurationItemBase* aItem );

    /**

     * Remove configurator from item

     * @param aContext. Item to be removed.

     */

    IMPORT_C void RemoveConfigurator( CXIMPConfigurationItemBase* aItem );

public: // From CXIMPSubscriptionItemBase

    /**

     * @see CXIMPSubscriptionItemBase

     */

    IMPORT_C TBool IsContext( MXIMPPscContext* aContext ) const;    

    /**

     * @see CXIMPSubscriptionItemBase

     */

    IMPORT_C void ForceClose();

public: // From MXIMPConfigurationItem

protected: // Helpers

    /**

     * For linear ordering by pointers

     */

    static TInt OrderOfItems( const CXIMPConfigurationItemBase& aFirst, 

                              const CXIMPConfigurationItemBase& aSecond );

protected: // New interface methods.

protected: // Data

    /**

     * Configured contexts.

     */

    RPointerArray< MXIMPPscContext > iConfigContexts;

    RPointerArray< MXIMPPscContext > iPreConfigContexts;

    RPointerArray< CXIMPConfigurationItemBase > iConfigItems;

    RPointerArray< CXIMPConfigurationItemBase > iPreConfigItems;

    };

/* ======================================================================== */

#endif // CXIMPPSCCONFIGURATIONITEMBASE_H