homescreensrv_plat/ai_utilities_api/inc/contentprioritymap.h
author Christian Morlok <symbian.org@christianmorlok.de>
Wed, 07 Apr 2010 14:35:19 +0200
branchv5backport
changeset 54 666a2952b5b3
parent 0 79c6a41cd166
permissions -rw-r--r--
renamed dlls+exe to prevent conflicts with existing files in emulator; changelog attached. * renamed dlls/exe: - aifw.dll to aifw_hs.dll - cputils to cputils_hs - aiidleint.dll to aiidleint_hs.dll - aiutils.dll to aiutils_hs.dll - MenuInterface.dll to MenuInterface_hs.dll - XCFW.dll to XCFW_hs.dll - homescreen.exe to homescreen_hs.exe - ailaunch.exe to ailaunch_hs.exe * new UID for Active Idle (aifw_hs.dll, aiidleint_hs.dll and homescreen.exe): #define AI_UID3_AIFW_COMMON 0xEDFF45C4 (was 0x102750F0 = 271012080) * new UID for cputils_hs.dll: 0xE3E7134E (was 0x20016B7F = 536963967) * new UID for AI Utilities Factory (aiutils_hs.dll): 0xEC55106C (was 0x10281865 = 271063141) * new UID for MenuInterface_hs.dll: 0xEEE24485 (was 0x10210EAB = 270601899) * new UID for XCFW_hs.dll: 0xEB12332F (was 0x10210EA0 = 270601888) * new UID for ailaunch_hs.exe: 0xEF5A047A (was 0x200286E3 = 537036515)

/*
* Copyright (c) 2005-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:  
*
*/


#ifndef C_CONTENTPRIORITYMAP_H
#define C_CONTENTPRIORITYMAP_H

#include <e32base.h>
#include <e32hashtab.h>

namespace AiUtility {

/**
 *  Content priority map for UI controllers.
 *
 *  @lib aiutils_hs_hs.lib
 *  @since S60 3.2
 */
class CContentPriorityMap : public CBase
    {

public:
    /**
     * Creates and returns a new instance of this class.
     *
     * @post CurrentPriority(*) == KErrNotFound
     */
    IMPORT_C static CContentPriorityMap* NewL();

    virtual ~CContentPriorityMap();

    /**
     * Returns the current priority assigned to UI element.
     *
     * @param aUiElementId  textual identifier of the UI element.
     * @return Current priority set to ui element or KErrNotFound if not set.
     */
    IMPORT_C TInt CurrentPriority( const TDesC8& aUiElementId ) const;

    /**
     * Sets the current priority assigned to UI element.
     *
     * @param aUiElementId  textual identifier of the UI element.
     * @param aPriority     priority value to set.
     * @return KErrNone if priority was set succesfully, otherwise one of
     *         the system-wide error codes.
     * @post CurrentPriority(aUiElementId) == aPriority
     */
    IMPORT_C TInt SetCurrentPriority( const TDesC8& aUiElementId, TInt aPriority );

    /**
     * Clears the current priority assigned to UI element.
     *
     * @param aUiElementId  textual identifier of the UI element.
     * @post CurrentPriority(aUiElementId) == KErrNotFound
     */
    IMPORT_C void ClearPriority( const TDesC8& aUiElementId );

    /**
     * Clears all priority assignments of this map.
     */
    IMPORT_C void Reset();
    
    /**
     * Tests if content with given priority may override
     * current content in given ui element.
     *
     * @param aUiElementId  textual identifier of the UI element.
     * @param aNewPriority  priority of the new content.
     */
    IMPORT_C TBool OverrideContent( const TDesC8& aUiElementId, TInt aNewPriority ) const;

private:

    CContentPriorityMap();

private: // data

    RPtrHashMap<TDesC8,TInt> iPriorityMap;

    };


} // namespace AiUtility

#endif // C_CONTENTPRIORITYMAP_H