menufw/menufwui/mmwidgets/inc/mmsubcellssetupcode.h
changeset 0 f72a12da539e
child 4 4d54b72983ae
--- /dev/null	Thu Jan 01 00:00:00 1970 +0000
+++ b/menufw/menufwui/mmwidgets/inc/mmsubcellssetupcode.h	Thu Dec 17 08:40:49 2009 +0200
@@ -0,0 +1,114 @@
+/*
+* Copyright (c) 2009 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:  
+*  Version     : 2 << Don't touch! Updated by Synergy at check-out.
+*
+*/
+
+#ifndef MMSUBCELLSSETUPCODE_H
+#define MMSUBCELLSSETUPCODE_H
+
+#include <e32def.h>
+
+const TInt KNumberOfBitsToStoreSubcellType = 3;
+const TInt KNumberOfBitsToStoreTemplateId = 8;
+const TInt KNumberOfBitsToStoreIsCurrentInfo = 1;
+
+/**
+ * The purpose of this class is to provide a very fast way
+ * of determining whether two particular ways of setting up
+ * subcells are compatible (compatible == the same).
+ * 
+ * It is important that the methods of this class are used
+ * in a fixed order:
+ * 1. (Optional) Clear() - only needed if this object was
+ *    used before.
+ * 2. AddSubcellInfo() - for every subcell being set up
+ *    and in the same order.
+ * 3. AddTemplateInfo
+ * 4. AddIsCurrentInfo
+ * It was assumed that there would never be more than 6
+ * MmTemplateContants::KSubCellsCount subcells. If that
+ * should ever change, consider changing the type of iCode
+ * member to TUint64.
+ * Default assignment operator and copy constructor are ok
+ * for this class.
+ */
+NONSHARABLE_CLASS( TMmSubcellsSetupCode )
+    {
+public:
+    /**
+     * Values of this enum must be low enough to be stored in
+     * just KNumberOfBitsToStoreSubcellType bits (currently the
+     * maximum value allowed is 7).
+     */
+    enum TSubcellType
+        {
+        ENoSubcell = 0,
+        EGraphicsSubcell = 1,
+        ETextSubcell = 2,
+        EBackdropSubcell = 3
+        };
+public:
+    /**
+     * Standard C++ constructor.
+     */
+    inline TMmSubcellsSetupCode();
+    /**
+     * Adds the information about what type of subcell was just
+     * set up.
+     * @param aSubcellType Subcell type (any value defined in the
+     *        TSubcellType enum).
+     */
+    inline void AddSubcellInfo( TSubcellType aSubcellType );
+    /**
+     * Adds information about the template used.
+     * 
+     * @param aTemplateIdentifier Template idetifier obtained from
+     *        CMmItemsDataCache::GetTemplateIdentifierL().
+     */
+    inline void AddTemplateInfo( TInt aTemplateIdentifier );
+    /**
+     * Adds information whether subcells setup was made for a
+     * highlighted item.
+     */
+    inline void AddIsCurrentInfo( TBool aIsCurrent );
+    /**
+     * Clears all the information stored in this object so that
+     * it can be-reused.
+     */
+    inline void Clear();
+    /**
+     * Comparison operator ==.
+     * @param aOther object to compare with this object.
+     * @return ETrue if objects equal.
+     */
+    inline TBool operator==( const TMmSubcellsSetupCode aOther ) const;
+    /**
+     * Comparison operator !=.
+     * @param aOther object to compare with this object.
+     * @return ETrue if objects differ.
+     */
+    inline TBool operator!=( const TMmSubcellsSetupCode aOther ) const;
+
+protected: // data
+    /**
+     * The subcells setup code.
+     */
+    TUint32 iCode;
+    };
+
+#include "mmsubcellssetupcode.inl"
+
+#endif // MMSUBCELLSSETUPCODE_H