brctlsampleapplinkresolver.h

S60上实现嵌入式浏览器,可以在应用程序中嵌入浏览器,实现IE功能

/*
* ==============================================================================
*  Name        : BrCtlSampleAppLinkResolver.h
*  Part of     : BrCtlSampleApp
*  Interface   : Browser Control API
*  Description : Observer interface which handles resolving embedded links
*  Version     : 
*
*  Copyright (c) 2005-2006 Nokia Corporation.
*  This material, including documentation and any related 
*  computer programs, is protected by copyright controlled by 
*  Nokia Corporation.
* ==============================================================================
*/


#ifndef BRCTLSAMPLEAPPLINKRESOLVER_H
#define BRCTLSAMPLEAPPLINKRESOLVER_H

// INCLUDES
#include <BrCtlLinkResolver.h>
#include <BrCtlInterface.h>

// CLASS DECLARATION

/**
* CBrCtlSampleAppLinkResolver class. 
* This class inherits from the MBrCtlLinkResolver interface.
* This class is used to provide a callback mechanism for receiving the content of an embedded 
* link or the content of a user-initiated load request.
*/
class CBrCtlSampleAppLinkResolver : public CBase, public MBrCtlLinkResolver
    {
    public:  // Constructors and destructor

        /**
        * Two-phased constructor.
        */
        static CBrCtlSampleAppLinkResolver* NewL();

        /**
        * Destructor.
        */
        ~CBrCtlSampleAppLinkResolver();

    	/**
    	* Browser plug-in calls this method when embedded link is found. Used with ECapabilityClientResolveEmbeddedURL
        * @since 2.8
    	* @param aEmbeddedUrl The url of the embedded content
    	* @param aCurrentUrl The url of the current page
    	* @param aLoadContentType The expected type of the embedded content
    	* @param aEmbeddedLinkContent A callback interface to return the embedded content
    	* @return EFalse, if the browser will resolve the link
    	*/
        TBool ResolveEmbeddedLinkL(const TDesC& aEmbeddedUrl,
    		                       const TDesC& aCurrentUrl,
        	                       TBrCtlLoadContentType aLoadContentType, 
        	                       MBrCtlLinkContent& aEmbeddedLinkContent) ; 
		
    	/**
    	* Browser plug-in calls this method when the user requests to load content via selecting a link, or any other way. Used with ECapabilityClientNotifyURL 
        * @since 2.8
    	* @param aUrl The requested url
    	* @param aCurrentUrl The url of the current page
    	* @param aBrCtlLinkContent A callback interface to return the embedded content
    	* @return EFalse, if the browser will resolve the link
    	*/
        TBool ResolveLinkL(const TDesC& aUrl, const TDesC& aCurrentUrl,
                           MBrCtlLinkContent& aBrCtlLinkContent) ;

		/**
		* Cancel all outstanding resolving operations
        * @since 2.8
    	* @return void
    	*/
        void CancelAll() ;

    private:
	    /**
        * By default Symbian 2nd phase constructor is private.
        */
        void ConstructL();

	    /**
        * Find if the scheme if file://
        */
        TBool IsFileScheme(const TDesC& aFileName);

	    /**
        * Read the file.
        */
        HBufC8* ReadFileLC(const TDesC& aFileName);

	    /**
        * Rcognize the mime type.
        */
        HBufC* RecognizeLC(const TDesC& aFileName, const TDesC8& aData);

	    /**
        * Translate the file name from a URL to a valid file name in the system..
        */
        TBool GetFileNameL(const TDesC& aFileName);

    private:   // data
        // The loaded file's name. This is different from the URL. It does not contain the scheme.
        HBufC* iFileName;
    };

#endif      // BRCTLSAMPLEAPPLINKRESOLVER_H
            
// End of File