--- /dev/null	Thu Jan 01 00:00:00 1970 +0000
+++ b/uiresources_pub/skins_api/inc/AknsWallpaperUtils.h	Thu Dec 17 09:14:12 2009 +0200
@@ -0,0 +1,79 @@
+/*
+* 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