browserui/browser/BrowserAppInc/BrowserAppViewBase.h
author Kiiskinen Klaus (Nokia-D-MSW/Tampere) <klaus.kiiskinen@nokia.com>
Fri, 08 May 2009 08:18:43 +0300
changeset 10 57d5b8e231c4
parent 0 84ad3b177aa3
permissions -rw-r--r--
Revision: 200915 Kit: 200918

/*
* Copyright (c) 2007 Nokia Corporation and/or its subsidiary(-ies).
* All rights reserved.
* This component and the accompanying materials are made available
* under the terms of the License "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: 
*      Declaration of class CBrowserAppViewBase.
*      
*
*/


#ifndef BROWSER_APP_VIEW_BASE_H
#define BROWSER_APP_VIEW_BASE_H

// INCLUDE FILES
#include <aknview.h>

// FORWARD DECLARATION

class MApiProvider;

// CLASS DECLARATION

/**
*  Class to encapsulate a softkey pair made up of an Command ID and Resource qtn
*/
class TSKPair
	{
public:
    /**
    * Constructor.
    * @param NONE. command and qtn are set to default.
    */
	TSKPair();

    /**
    * Constructor.
    * @param Command and Resource IDs
    */
	TSKPair(TInt aId,TInt aRsc);
	
	/**
	* check to see if command/qtn are not currently set to the default assignment
	*/
	TBool IsAssigned();
	
	/**
	* define an == operator to check pair equality
	* @param TSK pair
	*/
	TBool operator==(TSKPair aSKPair);
	
	/**
	* define an = operator for assignment
	* @param TSK pair
	*/
	void operator=(TSKPair aSKPair);
	
	/**
	* a function to set the pair directly
	* @param Command and Resource Ids
	*/
	void setPair(TInt aId, TInt aRsc);
	
	/**
	* retrieve the command ID
	*/
	TInt id() { return iCmdId; }
	
	/**
	* retrieve the qtn resource ID
	*/
	TInt qtn() { return iQtnRsc; }
private:

	/**
	* private variables to hold command and resource ids
	*/
	TInt iCmdId;
	TInt iQtnRsc;
	};

/**
*  Base class all of the browser's views. Allows CBA setting and holds pointer
*  to API provider.
*  @lib Browser.app
*  @since Series 60 1.2
*/
class CBrowserViewBase : public CAknView
    {
    public:     // construction

        /**
        * Constructor.
        * @param aApiProvider The API provider
        */
        CBrowserViewBase( MApiProvider& aApiProvider );

    public:     // new methods

        /**
        * Get the API provider.
        * @since Series 60 1.2
        * @return The API provider
        */
        MApiProvider& ApiProvider();

        /**
        * Update the view's CBA, according to its current state.
        * This will call the view's CommandSetResourceIdL to get the
        * command set's resource id and then change the command set to that.
        * Note, there is no Push/Pop of CBA-s! The CBA which changes is always
        * that of the view; that is, if there is another CBA Push()-ed on top
        * of it (e.g. dialogs etc.), that will be unchanged.
        * @since Series 60 1.2
        */
        void UpdateCbaL();

        /**
        * Switch cba visibility, checking landscape state
        * @param aVisible Visibility
        */
        void MakeCbaVisible(TBool aVisible);

        /**
        * Update goto pane, if it is present in the view.
        * @since Series 60 1.2
        */
        virtual void UpdateGotoPaneL();

        /**
        * Clear CBA.
        * @since Series 60 1.2
        */
        void ClearCbaL();

        /**
        * Return command set id, to be displayed.
        * Derived classes should implement this method.
        * @since Series 60 1.2
        * @return
        *   - 0 if the command set should not be changed\n
        *   - Otherwise, the desired command set's resource id
        */
        virtual TInt CommandSetResourceIdL() = 0;

		/**
		* Set command set lsk,rsk,msk dynamically via pointers.
		* Derived classes should implement, though it can be empty.
		* If it does nothing, empty softkeys will be assigned
		* @since 5.0
		*/
		virtual void CommandSetResourceDynL(TSKPair &lsk, TSKPair &rsk, TSKPair &msk) = 0;

        /**
        * Handles client rect changes
        */
        virtual void HandleClientRectChange() = 0;
        
        /**
        * Gets the id of the previous active view.
        */
        inline TUid GetPreviousViewID()
            { return iPreviousViewID; }
                
        /**
        * Sets the id of the previous active view.
        * @param aUid UID of previous view
        */
        inline void SetPreviousViewID(TUid aUid)
            { iPreviousViewID = aUid; }
	
		/**
		* gets the current view's id
		*/
		virtual TUid Id() const = 0;
                
		virtual void LaunchSearchApplicationL( const TDesC& aSearchString );
    //private:
	protected:

        MApiProvider& iApiProvider; // API provider
        
        // Id of the view which was active before this view.
        TUid iPreviousViewID;
        
     
    private:
    	// For each child view class, track
    	// the last command set, dynamic lsk,rsk,msk settings
    	// to update CBA as little as possible
    	TInt iLastCommandSet;
    	TSKPair iLastLSK;
    	TSKPair iLastRSK;
    	TSKPair iLastMSK;
    };

#endif// End of File