2 * Copyright (c) 2002-2004 Nokia Corporation and/or its subsidiary(-ies).
4 * This component and the accompanying materials are made available
5 * under the terms of "Eclipse Public License v1.0"
6 * which accompanies this distribution, and is available
7 * at the URL "http://www.eclipse.org/legal/epl-v10.html".
9 * Initial Contributors:
10 * Nokia Corporation - initial contribution.
14 * Description: Defines an internal concrete class CAknsAppSkinInstance and
15 * related types. This class encapsulates the concrete skin
16 * instance which is a singleton in thread scope.
21 #ifndef AKNSWALLPAPERUTILS_H
22 #define AKNSWALLPAPERUTILS_H
30 Special error codes for SetIdleWallpaper.
34 // Returned when the drm protected image has
35 // only preview rights
36 KAknsWpuErrorPreviewOnly = -8000
40 * An utility class for manipulating the Idle state wallpaper. This function will show
41 * all drm related messages and queries, if the content is drm protected.
43 * No copies of the given file, but the file is used directly where it is located.
48 class AknsWallpaperUtils
52 * Sets the idle state wallpaper
54 * @param aFilename, the filename(incl. full path) of the image to be
55 * set as the idle state wallpaper, or KNullDesC if wallpaper is to
56 * be removed. If resource id:s are given, the user must ensure that
57 * the correct resource file is loaded to the given aCCoeEnv. The
58 * waitnote is type of CAknWaitNoteWrapper and is automatically launched
59 * when correct resource id:s are given.
61 * @param aCoeEnv a valid pointer to Control Environment, or NULL. As this function will potentially
62 * show drm related messages, a valid coeenv is needed. If no messages are wanted, NULL can be given
63 * as the parameter. Note that even when passing NULL, DRM related stuff will not be skipped, but
64 * they are done silenty.
66 * @param aWaitNoteResourceTextID the resource id of the waitnote text to show
67 * @param aWaitNoteResourceID the resource id of the wait note to show.
68 * @return KErrNone on success or one of the system wide error codes.
70 IMPORT_C static TInt SetIdleWallpaper(const TDesC& aFilename, CCoeEnv* aCoeEnv, TInt aWaitNoteTextResourceID = 0, TInt aWaitNoteResourceID = 0);
72 IMPORT_C static TInt SetSlidesetWallpaper(CDesCArray& aSelectedFiles, CCoeEnv* aCoeEnv, TInt aWaitNoteTextResourceID = 0, TInt aWaitNoteResourceID = 0);
77 #endif // AKNSAPPSKININSTANCE_H