Browser Launcher API

Comments

28 Sep
2009

Article Review by savaj (20090928)

This article demonstrates the use of Browser Launcher API to launch built-in S60 browser in embedded mode. The browser can be can be launched in synchronous and asynchronous operation with given parameter. The article shows the both way,synchronous operation and asynchronous operation, to launch browser with parameter. Note that this API, Browser Launcher API, is not part of the public SDK. So you have to download it from SDK API Plug-in, before using it.

---

Log in or Join to leave comments.

Article Metadata

---

Code Example

Source file: Media:BrowserLauncherEx.zip

---

Article

Created: ltomuta (16 Jun 2007)

Last edited: hamishwillee (08 May 2013)

Note: :This API is not part of the public SDK. It can be found in the SDK API Plug-in.

Browser Launcher API can be used to launch the built-in S60 browser in embedded mode with the given parameters. It also provides the capability to override certain settings. CBrowserLauncher::LaunchBrowserEmbeddedL() will launch the browser and its parameters are used to change the settings (thus, the behavior) of the browser.

We can override the settings of the browser with the help of TBrowserOverriddenSettings::SetBrowserSetting(), for example the screen can be changed to small size (EBrowserOverSettingsSmallScreen), font size (EBrowserOverSettingsFontSize) etc.

MDownloadedContentHandler is an interface for handling downloaded content. We can implement it (but don't have to) if we want to handle content that has been downloaded by Browser. This can be acheived by using HandleContentL() of MDownloadedContentHandler.

This operation can be done in synchronous and asynchronous ways using CBrowserLauncher class.

Header Files:

#include <browseroverriddensettings.h> 
#include <browserlauncher.h>

Link against:

LIBRARY    browserlauncher.lib

Capabilities Required:

CAPABILITY    None

Example code

_LIT(KUrl,"http://www.google.com");
 
void CTestBrowserAPIAppUi::ConstructL()
    {
    ...
    CBrowserLauncher* iBrLauncher = CBrowserLauncher::NewL();  
    ...   
    }
 
void CTestBrowserAPIAppUi::LaunchBrowserL()
    {
    //Implementation of the file based content handler.  
    MDownloadedContentHandler*  aContentHandler;
 
    //Embedded Browser application exit observer.
    MAknServerAppExitObserver*  aExitObserver;
 
    //Overridden user preferences.
    TBrowserOverriddenSettings*  aSettings; 
 
    //Asynchronous operation to launch the browser with KUrl as default page
    iBrLauncher->LaunchBrowserEmbeddedL( KUrl, aContentHandler = NULL,
                                         aExitObserver = NULL,aSettings = NULL); 
 
    //Synchronous operation to launch the browser with KUrl as default page
    iBrLauncher->LaunchBrowserSyncEmbeddedL( KUrl, aContentHandler = NULL,
                                             aSettings = NULL);
    }

Example Application

File:BrowserLauncherEx.zip