/** 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 "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: 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 <e32base.h>#include <badesca.h>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