/*
* Copyright (c) 2005 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"
* which accompanies this distribution, and is available
* at the URL "http://www.eclipse.org/legal/epl-v10.html".
*
* Initial Contributors:
* Nokia Corporation - initial contribution.
*
* Contributors:
*
* Description:  
*
*/


#ifndef __AKNADAPTIVESEARCH_H__
#define __AKNADAPTIVESEARCH_H__

// INCLUDES
#include "AknAdaptiveSearchGrid.h"
#include "AknAdaptiveSearchGridObserver.h"
#include <cenrepnotifyhandler.h>    // CenRep for AS

// FORWARD DECLARATIONS
class CAknSearchField;
class MAdaptiveSearchTextObserver;
class CRepository;
//class CCenRepNotifyHandler;

// CLASS DECLARATION

/**
 *  The class to provide adaptive search for the application
 *
 *  @lib avkon.lib
 *  @since Series 60 5.0
 */

class CAknAdaptiveSearch : public CBase, 
                           public MAknAdaptiveSearchGridObserver,
                           public MCenRepNotifyHandlerCallback,
			               public MCoeControlObserver								   
    {
    public: // Constructors and destructor

    /**
     * Two-phased constructor.
     *
     * @param aTextLimit The limit length of search field
     * @param aFieldStyle The same flag as search fi1eld
     * @return Pointer to the created adaptive search grid object
     */
    static CAknAdaptiveSearch* NewL( const TInt aTextLimit, TInt aFieldStyle);
    
    /**
     * Two-phased constructor.
     *
     * @param aTextLimit The limit length of search field
     * @param aFieldStyle The same flag as search field.
     * @return Pointer to the created adaptive search grid object
     */
    static CAknAdaptiveSearch* NewLC( const TInt aTextLimit, TInt aFieldStyle );
    
        /**
         * Destructor.
         */
         ~CAknAdaptiveSearch();

    public:  // From MAknAdaptiveSearchGridObserver

        /**
         * Handles an event from an observed adaptive search grid
         *
         * @param aCommand The control which sent the event        
         */       
         void ProcessCommandL( TInt aCommand );
		 
    public:  // From MCoeControlObserver

        /**
         * From MCoeControlObserver. Handles an event from an observed control.
         * If this component has observer, then a EEventStateChanged is sent 
         * to it when a item is selected from the grid
         * 
         * @param aControl The control that sent the event.
         * @param aEventType The event type. 
         */     
	     void HandleControlEventL( CCoeControl *aControl, TCoeEvent aEventType );
	     
   public: // from MCenRepNotifyHandlerCallback     
         void HandleNotifyInt( TUint32 aId, TInt aNewValue ); 	   
		           
   public: // New functions           
               
        /**
         * Shows adaptive search grid.
         */
         void ShowAdaptiveSearchGridL();        
      
    	/**
         * Hides adaptive search grid.
         */
         void HideAdaptiveSearchGridL();           
  
  		/**
         * Invert adaptive search grid.
         * @param aSelectAll If true, select all content in adaptive search editor.
         */
         void InvertAdaptiveSearchGridVisibilityL( TBool aSelectAll = EFalse );
  		
        /**
      	 *  Set characters for buttons to adaptive search grid
      	 *        	 
      	 *  @param aGridChars The characters for adaptive search grid.      	 
         */
	     void SetButtonCharsL( const TDesC& aGridChars );
  
	    
	    /**
	     * Sets a search field for this control.
	     *	     
	     * @param aSearchField A pointer to a search field object.
	     */	
	     void SetSearchField( CAknSearchField *aSearchField );
	     
	   /** 
    	* Adds an adaptive search text observer. Duplicates are not checked 
    	* (i.e. adding the same observer multiple times is not prevented). 
   		* 
   		* @since 5.0 
    	* @param aObserver Must be non-NULL. 
    	*/ 
    	void AddAdaptiveSearchTextObserverL( MAdaptiveSearchTextObserver* aObserver );

       /** 
    	* Removes an adaptive search text observer. 
    	* 
    	* @since 5.0 
   	 	* @param aObserver The observer to be removed. 
    	* @return ETrue if removal ok, EFalse if observer was not removed (not 
    	* found from the list of observers). 
    	*/ 
    	TBool RemoveAdaptiveSearchTextObserver( MAdaptiveSearchTextObserver* aObserver );	
 
    	/**
    	 * Update adaptive search grid skin.
    	 */
    	void UpdateGridSkinL();
    	
   public:
    	
    	/**
         * When the rect of find pane is set, this functions will be notified
         * to record the size of it.
    	 */
    	void SaveFindPaneRect( const TRect &aRect );
    	
   private: // Constructors

         /**
          * C++ default constructor.
          */
          CAknAdaptiveSearch();          
        
    /**
     * Symbian 2nd phase constructor.
     *
     * @param aTextLimit The limit length of search field
     * @param aFieldStyle The same flag as search field
     */
    void ConstructL( const TInt aTextLimit, TInt aFieldStyle );       
    
   private: // Member variables	    
       
	    // Observer to report adaptive search text changes, not owned
       	MAdaptiveSearchTextObserver* iAdaptiveSearchTextObserver; 
       	
       	CAknAdaptiveSearchGrid* iAdaptiveSearchGrid;              	       	
        	
       	CAknSearchField* iSearchField; // not owned
       	
       	// Chars of grid from filtered items
       	HBufC* iGridChars;       	
       	
       	// Limit length of search field 
       	TInt iTextLimit;  
       	
       	TBool iBlockFlag;	  

        // Handle to Central Repository.
        CRepository* iCenRep;    
        
        // For CenRep value change notifications. 
        CCenRepNotifyHandler* iCenRepNotifyHandlerChinese;  
        CCenRepNotifyHandler* iCenRepNotifyHandlerPRC;
        CCenRepNotifyHandler* iCenRepNotifyHandlerTW;
        CCenRepNotifyHandler* iCenRepNotifyHandlerHongkong;        	  
    };

#endif // __AKNADAPTIVESEARCH_H__

// End of File