1 /*

     2 * Copyright (c) 2007-2007 Nokia Corporation and/or its subsidiary(-ies).

     3 * All rights reserved.

     4 * This component and the accompanying materials are made available

     5 * under the terms of the License "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".

     8 *

     9 * Initial Contributors:

    10 * Nokia Corporation - initial contribution.

    11 *

    12 * Contributors:

    13 *

    14 * Description:  This Class provides information of Application installed on phone.

    15 *				 				 

    16 *

    17 */

    18 

    19 

    20 #ifndef __APPITERATOR_H__

    21 #define __APPITERATOR_H__

    22 

    23 

    24 #include <e32base.h>

    25 class RApaLsSession ;

    26 

    27 #include "appmanagercommon.h"

    28 

    29 /**

    30 * This is iterator class which iterates on the applications

    31 * installed on phone

    32 *

    33 * @since  Series60 v3.2

    34 

    35 */

    36 class CAppIterator: public CBase, public MIterator

    37 	{

    38 	public:

    39 		 /**

    40 		* Returns the instance of CAppIterator.

    41 		* @since  Series60 v3.2

    42 		* @param  aApaLsSession Instance of RApaLsSession(App arch server) class

    43 		* @param  aFilterParam  Instance of CFilterParam which is the filter param

    44 		* @return CAppIterator* return the instance of CAppIterator class

    45 		*/

    46 

    47 		static CAppIterator* NewL(RApaLsSession& aApaLsSession,const CFilterParam* aFilterParam);

    48         

    49         /**

    50     	* Destructor.

    51     	*/

    52 		~CAppIterator();

    53 		

    54 		 /**

    55 		* It gives the instance of MInfoMap which contains the information about next application on 

    56 		* iterator list.

    57 		* @since  Series60 v3.2

    58 		* @param  aInfo Instance of MInfoMap

    59 		* @return TBool returns ETrue when get next application or else False when no more applications

    60 		* 				are present on the iterator list

    61 		*/

    62 		virtual TBool  NextL(MInfoMap*& aInfo);

    63 

    64        

    65 		

    66         /**

    67     	* It resets the iterator;

    68     	*/

    69 		virtual void Reset();

    70 

    71 

    72 		private:

    73 

    74 

    75      	/**

    76         * Constructor

    77         * @param aApaLsSession Instance of RApaLsSession class

    78         * @since  Series60 v3.2

    79         */

    80 		CAppIterator(RApaLsSession& aApaLsSession);

    81 

    82      	/**

    83         * Two-phased constructor

    84         * @param aFilterParam  Instance of CFilterParam which is the filter param

    85         * @return void

    86         * @since  Series60 v3.2

    87         */

    88 		void ConstructL(const CFilterParam* aFilterParam);

    89 

    90 		private:

    91 

    92         /**

    93         * Reference to the RApaLsSession instance

    94         */  

    95 		RApaLsSession&  iApaLsSession;

    96 

    97 

    98         /**

    99         * Uid of the application 

   100         */  

   101 		TUid iUid;

   102 

   103         /**

   104         * TBool boolean instance

   105         */  

   106 		TBool iHandler;	

   107 	

   108 

   109 	};

   110 

   111 

   112 

   113 #endif