1 /*

     2 * Copyright (c) 2006 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:   Contains CNcdNodeTransparentFolder class

    15 *

    16 */

    17 

    18 

    19 #ifndef NCD_NODE_TRANSPARENT_FOLDER_H

    20 #define NCD_NODE_TRANSPARENT_FOLDER_H

    21 

    22 

    23 #include <e32cmn.h>

    24 

    25 #include "ncdnodefolder.h"

    26 

    27 class CNcdNodeIdentifier;

    28 

    29 

    30 /**

    31  *  This class provides transparent features for the node.

    32  *

    33  *  @lib ?library

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

    35  */

    36 class CNcdNodeTransparentFolder : public CNcdNodeFolder

    37     {

    38     

    39 public:

    40 

    41     /**

    42      * @see CNcdNodeFolder::NewL

    43      *

    44      * @return CNcdNodeTransparentFolder* Pointer to the created object 

    45      * of this class.

    46      */

    47     static CNcdNodeTransparentFolder* NewL( CNcdNodeManager& aNodeManager,

    48                                             const CNcdNodeIdentifier& aIdentifier );

    49 

    50     /**

    51      * @see CNcdNodeTransparentFolder::NewL

    52      */

    53     static CNcdNodeTransparentFolder* NewLC( CNcdNodeManager& aNodeManager,

    54                                              const CNcdNodeIdentifier& aIdentifier );

    55 

    56 

    57     /**

    58      * Destructor

    59      */

    60     virtual ~CNcdNodeTransparentFolder();

    61 

    62 

    63 public: // CNcdNodeFolder

    64 

    65     /**

    66      * @see CNcdNodeFolder::ExternalizeL

    67      */

    68     virtual void ExternalizeL( RWriteStream& aStream );

    69 

    70 

    71     /**

    72      * @see CNcdNodeFolder::InternalizeL

    73      */

    74     virtual void InternalizeL( RReadStream& aStream );

    75 

    76 public:

    77 

    78     /**

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

    80      *

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

    82      * one level up.

    83      *

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

    85      */

    86     TBool HasExpiredOrMissingChildrenL();

    87 

    88 protected:

    89 

    90     /**

    91      * @see CNcdNodeFolder::CNcdNodeFolder

    92      */

    93     CNcdNodeTransparentFolder( CNcdNodeManager& aNodeManager,

    94         NcdNodeClassIds::TNcdNodeClassId aNodeClassId = NcdNodeClassIds::ENcdTransparentFolderNodeClassId, 

    95         NcdNodeClassIds::TNcdNodeClassId aAcceptedLinkClassId = NcdNodeClassIds::ENcdFolderNodeLinkClassId,

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

    97     

    98     /**

    99      * @see CNcdNodeFolder::ConstructL

   100      */

   101     virtual void ConstructL( const CNcdNodeIdentifier& aIdentifier );

   102 

   103 

   104     /** 

   105      * @see CNcdNodeFolder::ExternalizeDataForRequestL

   106      */

   107     virtual void ExternalizeDataForRequestL( RWriteStream& aStream ) const;    

   108     

   109     

   110 private:

   111     

   112     // Prevent these two if they are not implemented

   113     CNcdNodeTransparentFolder( const CNcdNodeTransparentFolder& aObject );

   114     CNcdNodeTransparentFolder& operator =( const CNcdNodeTransparentFolder& aObject );

   115     

   116     };

   117 

   118 

   119 #endif // NCD_NODE_TRANSPARENT_FOLDER_H