williamr@2: // Copyright (c) 1997-2009 Nokia Corporation and/or its subsidiary(-ies).
williamr@2: // All rights reserved.
williamr@2: // This component and the accompanying materials are made available
williamr@2: // under the terms of the License "Symbian Foundation License v1.0" to Symbian Foundation members and "Symbian Foundation End User License Agreement v1.0" to non-members
williamr@2: // which accompanies this distribution, and is available
williamr@2: // at the URL "http://www.symbianfoundation.org/legal/licencesv10.html".
williamr@2: //
williamr@2: // Initial Contributors:
williamr@2: // Nokia Corporation - initial contribution.
williamr@2: //
williamr@2: // Contributors:
williamr@2: //
williamr@2: // Description:
williamr@2: //
williamr@2: 
williamr@2: #ifndef __COEFEPFF_H__
williamr@2: #define __COEFEPFF_H__
williamr@2: 
williamr@2: #include <e32std.h>
williamr@2: 
williamr@2: class CCoeFepParameters;
williamr@2: class CCoeFep;
williamr@2: 
williamr@2: /** FEP factory function which must be exported by every FEP.
williamr@2: 
williamr@2: The function is called by the UI Control Framework when it loads the
williamr@2: FEP. It returns a fully constructed object of a CCoeFep-derived class, 
williamr@2: and passes ownership of that object to the caller.
williamr@2: 
williamr@2: The function can leave with any of the system-wide error codes,
williamr@2: for instance KErrNoMemory.
williamr@2: 
williamr@2: @publishedAll
williamr@2: @released
williamr@2: @param aConeEnvironment A reference to the application's control environment. 
williamr@2: @param aFullFileNameOfDll The full file name of the FEP's top-level DLL, i.e. 
williamr@2: something like "z:\system\fep\TFEP1.FEP". A FEP could use this parameter to 
williamr@2: work out the location of its resource file.
williamr@2: @param aFepParameters FEP parameters. These should simply be passed to 
williamr@2: CCoeFep::BaseConstructL().
williamr@2: @return A pointer to the newly created object belonging to a 
williamr@2: CCoeFep-derived class. */
williamr@2: IMPORT_C CCoeFep* NewFepL(CCoeEnv& aConeEnvironment, const TDesC& aFullFileNameOfDll, const CCoeFepParameters& aFepParameters);
williamr@2: 
williamr@2: /** Runs the FEP settings dialog.
williamr@2: 
williamr@2: The function is called by the FEPs control panel plug-in in order 
williamr@2: to run the settings dialog for the FEP. It must be exported by 
williamr@2: every FEP.
williamr@2: 
williamr@2: The function can leave with any of the system-wide error codes,
williamr@2: for instance KErrNoMemory.
williamr@2: 
williamr@2: Note: the FEP may or may not be loaded when this function is called.
williamr@2: 
williamr@2: @publishedAll
williamr@2: @released
williamr@2: @param aConeEnvironment A reference to the application's control environment.
williamr@2: @param aFullFileNameOfDll The full file name of the FEP's top-level DLL, i.e.
williamr@2: something like "z:\system\fep\TFEP1.FEP". */
williamr@2: IMPORT_C void SynchronouslyExecuteSettingsDialogL(CCoeEnv& aConeEnvironment, const TDesC& aFullFileNameOfDll);
williamr@2: IMPORT_C void Reserved_1();
williamr@2: IMPORT_C void Reserved_2();
williamr@2: IMPORT_C void Reserved_3();
williamr@2: IMPORT_C void Reserved_4();
williamr@2: IMPORT_C void Reserved_5();
williamr@2: IMPORT_C void Reserved_6();
williamr@2: IMPORT_C void Reserved_7();
williamr@2: IMPORT_C void Reserved_8();
williamr@2: 
williamr@2: #endif	// __COEFEPFF_H__