00001 /* 00002 * ============================================================================== 00003 * Name : AknsWallpaperUtils.h 00004 * Part of : Avkon Skins / Skin Library 00005 * Interface : ?Interface_category, ?Interface_name 00006 * Description : Defines an internal concrete class CAknsAppSkinInstance and 00007 * related types. This class encapsulates the concrete skin 00008 * instance which is a singleton in thread scope. 00009 * Version : ?Version 00010 * 00011 * Copyright © 2002-2004 Nokia Corporation. 00012 * This material, including documentation and any related 00013 * computer programs, is protected by copyright controlled by 00014 * Nokia Corporation. All rights are reserved. Copying, 00015 * including reproducing, storing, adapting or translating, any 00016 * or all of this material requires the prior written consent of 00017 * Nokia Corporation. This material also contains confidential 00018 * information which may not be disclosed to others without the 00019 * prior written consent of Nokia Corporation. 00020 * ============================================================================== 00021 */ 00022 00023 #ifndef AKNSWALLPAPERUTILS_H 00024 #define AKNSWALLPAPERUTILS_H 00025 00026 #include <e32base.h> 00027 #include <badesca.h> 00028 00029 class CCoeEnv; 00030 00031 /* 00032 Special error codes for SetIdleWallpaper. 00033 */ 00034 enum TAknsWpuError 00035 { 00036 // Returned when the drm protected image has 00037 // only preview rights 00038 KAknsWpuErrorPreviewOnly = -8000 00039 }; 00040 00041 /* 00042 * An utility class for manipulating the Idle state wallpaper. This function will show 00043 * all drm related messages and queries, if the content is drm protected. 00044 * 00045 * No copies of the given file, but the file is used directly where it is located. 00046 * 00047 * 00048 * 00049 */ 00050 class AknsWallpaperUtils 00051 { 00052 public: 00053 /* 00054 * Sets the idle state wallpaper 00055 * 00056 * @param aFilename, the filename(incl. full path) of the image to be 00057 * set as the idle state wallpaper, or KNullDesC if wallpaper is to 00058 * be removed. If resource id:s are given, the user must ensure that 00059 * the correct resource file is loaded to the given aCCoeEnv. The 00060 * waitnote is type of CAknWaitNoteWrapper and is automatically launched 00061 * when correct resource id:s are given. 00062 * 00063 * @param aCoeEnv a valid pointer to Control Environment, or NULL. As this function will potentially 00064 * show drm related messages, a valid coeenv is needed. If no messages are wanted, NULL can be given 00065 * as the parameter. Note that even when passing NULL, DRM related stuff will not be skipped, but 00066 * they are done silenty. 00067 * 00068 * @param aWaitNoteResourceTextID the resource id of the waitnote text to show 00069 * @param aWaitNoteResourceID the resource id of the wait note to show. 00070 * @return KErrNone on success or one of the system wide error codes. 00071 */ 00072 IMPORT_C static TInt SetIdleWallpaper(const TDesC& aFilename, CCoeEnv* aCoeEnv, TInt aWaitNoteTextResourceID = 0, TInt aWaitNoteResourceID = 0); 00073 00074 IMPORT_C static TInt SetSlidesetWallpaper(CDesCArray& aSelectedFiles, CCoeEnv* aCoeEnv, TInt aWaitNoteTextResourceID = 0, TInt aWaitNoteResourceID = 0); 00075 00076 }; 00077 00078 00079 // AKNSAPPSKININSTANCE_H 00080 #endif 00081 00082 // End of File