ui/viewmanagement/statehandler/inc/glxstatemanager.h
changeset 44 aa2fa096cbfb
parent 43 72396548277c
child 45 863223ea6961
--- a/ui/viewmanagement/statehandler/inc/glxstatemanager.h	Fri May 28 21:11:54 2010 +0530
+++ b/ui/viewmanagement/statehandler/inc/glxstatemanager.h	Fri Jun 11 17:53:15 2010 +0530
@@ -45,83 +45,157 @@
 	friend class TestGlxStateManager;
 	
 public :
+    /*
+     * Constructor
+     */
     GlxStateManager();
+    
+    /*
+     * Destructor
+     */
     virtual ~GlxStateManager();
+    
+    /*
+     * Fuction to launch the application from some external world
+     */
     void launchFromExternal();
+    
+    /*
+     * Clean the all externel data
+     */
     void cleanupExternal();
     
-    //internal exposed function
+    /*
+     *  Move the views to the multiple item selection state
+     */
     void enterMarkingMode();
+    
+    /*
+     * Exit from the multiselection state
+     */
     void exitMarkingMode();
+    
+    /*
+     * Execute the commant on multiple selected item
+     */
     bool executeCommand(qint32 commandId);
+    
+    /*
+     *  when application goes into background or come back to foreground
+     *  set and reset the background thumbnail generation property
+     */
+    bool eventFilter(QObject *obj, QEvent *ev);    
 
-signals :    
+signals :
+    /*
+     * Send the user activities ( command ) to the external world
+     */
     void externalCommand(int cmdId);
+    
+    /*
+     * TO send the signal to initialise the rest of items
+     * which is not created in the launch sequence
+     */
     void setupItemsSignal();
     
 public slots:
+    /*
+     * To launch the application
+     */
     void launchApplication();
+    
+    /*
+     * To handle the user action, view switching etc
+     */
     void actionTriggered(qint32 id);
+    
+    /*
+     * To create the items which is not created in the aluch sequence
+     */
     void setupItems();
+    
+    /*
+     * call back function to monitor the change in thumbnail manager
+     */
     void updateTNProgress( int count);
 
 public :
-/*
- * It will create a new state and replace the current state with new state in the stack.
- * It will use in the case of state switching.
- * use -1 if state does not have internal state
- */    
+    /*
+     * It will create a new state and replace the current state with new state in the stack.
+     * It will use in the case of state switching.
+     * use -1 if state does not have internal state
+     */    
     void changeState(qint32 newStateId, int internalState );
-/*
- * Go back to previous state 
- */    
+    
+    /*
+     * Go back to previous state 
+     */    
     void previousState();
 
-/*
- * Go back to a state in hierarchy and pop all the state upto that level.
- * if state is not found, then all the state from the hierachy is removed and create a new state on level 0
- * This function will be use in the case when more then one back is required in single event.
- */
+    /*
+     * Go back to a state in hierarchy and pop all the state upto that level.
+     * if state is not found, then all the state from the hierachy is removed and create a new state on level 0
+     * This function will be use in the case when more then one back is required in single event.
+     */
     void goBack(qint32 stateId, int internalState);
        
-/*
- * Create a new state and current state should be pushed into stack.
- * use -1 if state does not have internal state
- */  
+    /*
+     * Create a new state and current state should be pushed into stack.
+     * use -1 if state does not have internal state
+     */  
     void nextState(qint32 newStateId, int internalState );
 
-/*
- * It will delete the current model
- */      
+    /*
+     * It will delete the current model
+     */      
     void removeCurrentModel();
     
-/*
- * It will delete the all model used by state manager
- */
+    /*
+     * It will delete the all model used by state manager
+     */
     void cleanAllModel();
     
 
 private:
-/*
- * Factory function to create the state.
- */  
+
+    /*
+     *  Launch the harvesting and TN generation progress bar dialog
+     */
+    void launchProgressDialog();
+    
+    /*
+     * remove the harvesting and TN generation progress bar dialog
+     */
+    void vanishProgressDialog();
+    
+    /*
+     * Factory function to create the state.
+     */  
     GlxState * createState(qint32 state);
-/*
- * Factory function to create the model.
- */  	
+    
+    /*
+     * Factory function to create the model.
+     */  	
     void createModel(qint32 stateId, NavigationDir dir = NO_DIR);
-/*
- * Factory function to create the grid model.
- */  	
+
+    /*
+     * Factory function to create the grid model.
+     */  	
     void createGridModel(int internalState, NavigationDir dir = NO_DIR);
-/*
- * To set the fullscreen context based on the currrent orientation
- */    
+
+    /*
+     * To set the fullscreen context based on the currrent orientation
+     */    
     void setFullScreenContext();
+    
+    /*
+     * Apllication event handler function
+     */
     void eventHandler(qint32 &id);
-/*
- * A function to care the exit for application, in the case when application launch from internal and external
- */        
+    
+    /*
+     * A function to care the exit for application, in the case when application launch from internal and external
+     */        
     void exitApplication();
 
 private: