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

//

#ifndef __SSMCONDITIONALCALLBACK_H__

#define __SSMCONDITIONALCALLBACK_H__

#include <e32def.h>

#include <barsc2.h>

/**

Callback used by CSsmCommandListResourceReader when a decision needs to be made

on whether to include a command in a command list or not.

@publishedPartner

@released

*/

class MSsmConditionalCallback

	{

public:

	/**

	 * Called by CSsmCommandListResourceReader to determine if a command should be added to a command list.

	 *

	 * Both the resource ID for the condition information and the resource file are provided.

	 * This allows the conditional information at the resource ID to reference other resources

	 * in the same resource file.

	 * 

	 * @param aResourceFile The resource file which contains the conditional information.

	 * @param aResourceId The resource ID containing the conditional information.

	 *  

	 * @return ETrue if the command should be added to the list, EFalse if the command should not be added to the command list.

	 * 

	 * @publishedPartner

	 * @released

	 */

	virtual TBool ConditionalCommandAllowedL(CResourceFile& aResourceFile, TInt aResourceId) = 0;

	};

#endif