homescreensrv_plat/homescreen_information_api/inc/homescreendomainpskeys.h
changeset 116 305818acdca4
parent 99 7aaf39b772ac
--- a/homescreensrv_plat/homescreen_information_api/inc/homescreendomainpskeys.h	Wed Aug 18 10:39:24 2010 +0300
+++ b/homescreensrv_plat/homescreen_information_api/inc/homescreendomainpskeys.h	Mon Sep 13 13:26:33 2010 +0300
@@ -1,5 +1,5 @@
 /*
- * Copyright (c) 2009 Nokia Corporation and/or its subsidiary(-ies).
+ * Copyright (c) 2010 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"
@@ -31,9 +31,9 @@
 
 /*!
     P&S Key sub path to represent the state of the Home Screen. This property is updated when
-    Home screen state is changed. Valid values are defined by the enum EPSHsState.
+    Home screen state is changed. Valid values are defined by the enum EPSHomescreenState.
     
-    @see EPSHsState
+    \see EPSHomescreenState
 */
 const char HsStatePSKeySubPath[] = "state";
 
@@ -46,13 +46,56 @@
 /*!
     P&S Key to represent the state of the Home Screen for pure Symbian usage.
     This property is updated when Home screen state is changed. Valid values
-    are defined by the enum EPSHsState.
+    are defined by the enum EPSHomescreenState.
 */
 const TUint KHsCategoryStateKey = 0x1;
 #endif //SYMBIAN
+    
+/*!
+    Home screen state.
+    As Homescreen and Application Library are in the same process
+    EHomeScreenApplicationBackground and EHomeScreenApplicationForeground
+    information considers both of them simultaneously.
+*/
+enum EPSHomescreenState
+     {
+     /**
+     Invalid state. P&S key not initialized.
+     */
+     EHomeScreenInvalid = 0x0,
+     /**
+     Home Screen Application in background. 
+     */
+     EHomeScreenApplicationBackground = 0x1,
+     /**
+     Home Screen Application in foreground.
+     */
+     EHomeScreenApplicationForeground = 0x2,
+     /**
+     Home Screen in widget view.
+     */
+     EHomeScreenWidgetViewActive = 0x4,
+     /**
+     Home Screen in application library view.
+     */
+     EHomeScreenApplicationLibraryViewActive = 0x8,
+     /**
+     Home Screen in widget view in foreground.
+     */
+     EHomeScreenWidgetViewForeground = EHomeScreenApplicationForeground | EHomeScreenWidgetViewActive,
+     /**
+     Home Screen in application library view in foreground.
+     */
+     EHomeScreenApplicationLibraryViewForeground = EHomeScreenApplicationForeground | EHomeScreenApplicationLibraryViewActive 
+     };      
 
 /*!
     Home screen state.
+
+    \deprecated EPSHsState
+        is deprecated. Please use EPSHomescreenState instead.
+
+    \see EPSHomescreenState
 */
 enum EPSHsState
      {