MBrCtlSpecialLoadObserver Class Reference
#include
<mw/brctlspecialloadobserver.h>
| class MBrCtlSpecialLoadObserver |
Detailed Description
The MBrCtlSpecialLoadObserver class handles special load events, such as network connection, non-HTTP(S) load requests, and non-HTML responses.
Usage:
#include <brctlspecialloadobserver.h>
@see S60 Platform: Browser Control API Developer's Guide Version 2.0
@lib BrowserEngine.lib
@file brctlspecialloadobserver.h
*
Member Function Documentation
HandleDownloadL ( RArray< TUint > *, CDesCArrayFlat * )
Request the host applicaion to handle downloads
- Since
- 2.8
Attention: The host application should call the Download Manager to handle non-HTML content. Only GET requests are supported because the Browser Control must cancel the transaction before the Download Manager can take over. If a POST request is cancelled, the server may enter an unpredictable state. For POST requests, the Browser Control downloads the content before calling this function. It stores the content in a file whose name is passed to the host application by using the EParamLocalFileName parameter. The host application should check whether this parameter was passed by the Browser Control to determine whether the Browser Control already downloaded the content. If not, the host application should download the content.
| Parameters |
|---|
| aTypeArray | array of download parameter types |
| aDesArray | array of values associated with the types in the type array |
- Return Value
- ETrue if handled by the host application EFalse if not handled by the host application
HandleRequestL ( RArray< TUint > *, CDesCArrayFlat * )
Requests the host application to handle non-HTTP requests. It is expected that the host application will call the Scheme Dispatcher to handle these requests.
- Since
- 2.8
Attention: The browser checks the scheme to determine whether or not it is supported. The browser supports the following schemes: File scheme, HTTP scheme or HTTPS scheme If the URL contains a scheme that the browser does not support, such as RTSP, then the host application should pass the content to an application that can handle that scheme.
| Parameters |
|---|
| aTypeArray | Array of request parameters. Examples: URL, referrer header |
| aDesArray | Array of values corresponding to the types in aTypeArray |
- Return Value
- ETrue if the host application handles the scheme. EFalse if the host application cannot handle the scheme.
NetworkConnectionNeededL ( TInt *, TInt *, TBool *, TApBearerType * )
| void | NetworkConnectionNeededL | ( | TInt * | aConnectionPtr, |
| | TInt * | aSockSvrHandle, |
| | TBool * | aNewConn, |
| | TApBearerType * | aBearerType |
| | ) | [pure virtual] |
Request to create a network connection.
- Since
- 2.8
Attention: This function is called for every HTTP request for which the content was not found in the cache. This function is called whether or not a connection was established in a previous request. The host application determines whether to create a new connection or to use an existing connection.
| Parameters |
|---|
| aConnectionPtr | Pointer to the network connection. It must be type casted to an integer. If NULL, the Proxy Filter creates a network connection automatically. It must be type casted to an integer. |
| aSockSvrHandle | A handle to the socket server. |
| aNewConn | A flag if a new connection was created. If the connection is not new, proxy filter optimization will not read the proxy again from CommsBd. ETrue if a new connection was created. EFalse if a previously created connection was used. |
| aBearerType | Bearer type of the new connection. For example, GPRS, WCDMA. TapBearerType is defined in ApEngineConsts.h. |