diff -r 000000000000 -r 4e1aa6a622a0 sysstatemgmt/syslangutil/ssmlangselcmd/inc/ssmlangselcmdfactory.h --- /dev/null Thu Jan 01 00:00:00 1970 +0000 +++ b/sysstatemgmt/syslangutil/ssmlangselcmd/inc/ssmlangselcmdfactory.h Tue Feb 02 00:53:00 2010 +0200 @@ -0,0 +1,62 @@ +/* +* 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: +* Declaration of SsmLangSelCmdFactory class. +* +*/ + +#ifndef SSMLANGSELCMDFACTORY_H +#define SSMLANGSELCMDFACTORY_H + +#include + +class MSsmCustomCommand; + +/** + * Creates custom command objects. + * + * Custom commands are loaded by system state manager based on DLL name and + * function ordinal. + * Each DLL containing custom commands must offer factory methods for each + * custom command. + * The function ordinals must be exactly the same in emulator and HW builds + * or loading the custom command may have unpredictable results. + * + * SsmLangSelCmdFactory is a static class containing factory method of one + * custom command. It can be easily extended to contain factory methods of + * multiple custom commands by adding more member functions. + * + * It is better to implement own factory method for each separate command + * than to try to use command parameters to distinguis between them. + * Note that similar commands can be implemented in the same command class - + * just the factory methods need to be different. + */ +class SsmLangSelCmdFactory + { + +public: + + /** + * Creates and returns a custom command of type CSsmLangSelCmd. + * This method has function ordinal 1 in ssmlangselcmd.dll. + * + * @return A custom command object. + */ + IMPORT_C static MSsmCustomCommand* SsmLangSelCmdNewL(); + + // To add new custom commands to this DLL, add their factory methods here. + + }; + +#endif // SSMLANGSELCMDFACTORY