/*

* 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:   Contains CNcdNodeTransparentFolder class

*

*/

#ifndef NCD_NODE_TRANSPARENT_FOLDER_H

#define NCD_NODE_TRANSPARENT_FOLDER_H

#include <e32cmn.h>

#include "ncdnodefolder.h"

class CNcdNodeIdentifier;

/**

 *  This class provides transparent features for the node.

 *

 *  @lib ?library

 *  @since S60 ?S60_version *** for example, S60 v3.0

 */

class CNcdNodeTransparentFolder : public CNcdNodeFolder

    {

public:

    /**

     * @see CNcdNodeFolder::NewL

     *

     * @return CNcdNodeTransparentFolder* Pointer to the created object 

     * of this class.

     */

    static CNcdNodeTransparentFolder* NewL( CNcdNodeManager& aNodeManager,

                                            const CNcdNodeIdentifier& aIdentifier );

    /**

     * @see CNcdNodeTransparentFolder::NewL

     */

    static CNcdNodeTransparentFolder* NewLC( CNcdNodeManager& aNodeManager,

                                             const CNcdNodeIdentifier& aIdentifier );

    /**

     * Destructor

     */

    virtual ~CNcdNodeTransparentFolder();

public: // CNcdNodeFolder

    /**

     * @see CNcdNodeFolder::ExternalizeL

     */

    virtual void ExternalizeL( RWriteStream& aStream );

    /**

     * @see CNcdNodeFolder::InternalizeL

     */

    virtual void InternalizeL( RReadStream& aStream );

public:

    /**

     * Checks that are any of the children expired, missing, or is a child missing metadata.

     *

     * Transparent folders must be up to date because their content's are displayed

     * one level up.

     *

     * @return ETrue if some children are missing or expired.

     */

    TBool HasExpiredOrMissingChildrenL();

protected:

    /**

     * @see CNcdNodeFolder::CNcdNodeFolder

     */

    CNcdNodeTransparentFolder( CNcdNodeManager& aNodeManager,

        NcdNodeClassIds::TNcdNodeClassId aNodeClassId = NcdNodeClassIds::ENcdTransparentFolderNodeClassId, 

        NcdNodeClassIds::TNcdNodeClassId aAcceptedLinkClassId = NcdNodeClassIds::ENcdFolderNodeLinkClassId,

        NcdNodeClassIds::TNcdNodeClassId aAcceptedMetaDataClassId = NcdNodeClassIds::ENcdFolderNodeMetaDataClassId );

    /**

     * @see CNcdNodeFolder::ConstructL

     */

    virtual void ConstructL( const CNcdNodeIdentifier& aIdentifier );

    /** 

     * @see CNcdNodeFolder::ExternalizeDataForRequestL

     */

    virtual void ExternalizeDataForRequestL( RWriteStream& aStream ) const;    

private:

    // Prevent these two if they are not implemented

    CNcdNodeTransparentFolder( const CNcdNodeTransparentFolder& aObject );

    CNcdNodeTransparentFolder& operator =( const CNcdNodeTransparentFolder& aObject );

    };

#endif // NCD_NODE_TRANSPARENT_FOLDER_H