diff -r 666f914201fb -r 2fe1408b6811 epoc32/include/mw/aknswallpaperutils.h --- a/epoc32/include/mw/aknswallpaperutils.h Tue Nov 24 13:55:44 2009 +0000 +++ b/epoc32/include/mw/aknswallpaperutils.h Tue Mar 16 16:12:26 2010 +0000 @@ -1,1 +1,79 @@ -aknswallpaperutils.h +/* +* Copyright (c) 2002-2004 Nokia Corporation and/or its subsidiary(-ies). +* All rights reserved. +* This component and the accompanying materials are made available +* 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 +* which accompanies this distribution, and is available +* at the URL "http://www.symbianfoundation.org/legal/licencesv10.html". +* +* Initial Contributors: +* Nokia Corporation - initial contribution. +* +* Contributors: +* +* Description: Defines an internal concrete class CAknsAppSkinInstance and +* related types. This class encapsulates the concrete skin +* instance which is a singleton in thread scope. +* +*/ + + +#ifndef AKNSWALLPAPERUTILS_H +#define AKNSWALLPAPERUTILS_H + +#include +#include + +class CCoeEnv; + +/* + Special error codes for SetIdleWallpaper. +*/ +enum TAknsWpuError + { + // Returned when the drm protected image has + // only preview rights + KAknsWpuErrorPreviewOnly = -8000 + }; + +/* +* An utility class for manipulating the Idle state wallpaper. This function will show +* all drm related messages and queries, if the content is drm protected. +* +* No copies of the given file, but the file is used directly where it is located. +* +* +* @since 3.0 +*/ +class AknsWallpaperUtils +{ + public: + /* + * Sets the idle state wallpaper + * + * @param aFilename, the filename(incl. full path) of the image to be + * set as the idle state wallpaper, or KNullDesC if wallpaper is to + * be removed. If resource id:s are given, the user must ensure that + * the correct resource file is loaded to the given aCCoeEnv. The + * waitnote is type of CAknWaitNoteWrapper and is automatically launched + * when correct resource id:s are given. + * + * @param aCoeEnv a valid pointer to Control Environment, or NULL. As this function will potentially + * show drm related messages, a valid coeenv is needed. If no messages are wanted, NULL can be given + * as the parameter. Note that even when passing NULL, DRM related stuff will not be skipped, but + * they are done silenty. + * + * @param aWaitNoteResourceTextID the resource id of the waitnote text to show + * @param aWaitNoteResourceID the resource id of the wait note to show. + * @return KErrNone on success or one of the system wide error codes. + */ + IMPORT_C static TInt SetIdleWallpaper(const TDesC& aFilename, CCoeEnv* aCoeEnv, TInt aWaitNoteTextResourceID = 0, TInt aWaitNoteResourceID = 0); + + IMPORT_C static TInt SetSlidesetWallpaper(CDesCArray& aSelectedFiles, CCoeEnv* aCoeEnv, TInt aWaitNoteTextResourceID = 0, TInt aWaitNoteResourceID = 0); + +}; + + +#endif // AKNSAPPSKININSTANCE_H + +// End of File