Symbian
Symbian OS Library

SYMBIAN OS V9.3

[Index] [Spacer] [Previous] [Next]



Location: mchfparent.h
Link against: chf.lib

This item is not part of the S60 3rd Edition SDK for Symbian OS, Feature Pack 2.

Class MCHFParent

class MCHFParent;

Description

Interface for parents of content handlers.

It is used by content handlers for making requests, reporting errors and resolving URI's. An MCHFParent would usually be provided by either the application using CHF or a Content Handler that embeds other content handlers.

Members

Defined in MCHFParent:
HandleDrawRequestL(), HandleError(), HandleGenericRequestL(), HandleResizeRequestL(), MCHFParent_Reserved_1(), MCHFParent_Reserved_2(), MCHFParent_Reserved_3(), MCHFParent_Reserved_4(), ResolveUriL()


Member functions


ResolveUriL()

virtual HBufC8 *ResolveUriL(CCHFContentHandler &aRequester, const TDesC8 &aRelativeUri)=0;

Description

Resolves relative URIs.

This is called by a content handler if it has a relative URI that it doesn't know how to resolve.

Parameters

CCHFContentHandler &aRequester

The content handler that made the request

const TDesC8 &aRelativeUri

The relative URI that is to be resolved. Note that InetProtUtil URI functions should be used when resolving URI's.

Return value

HBufC8 *

NULL if the URI cannot be resolved, or the full resolved URI

Leave codes

KErrNoMemory

if there is not enough memory for the resolved URI to be allocated. Other error codes if the resolving fails


HandleError()

virtual void HandleError(CCHFContentHandler &aSource, TInt aErrorCode)=0;

Description

Handles errors from a content handler.

Parameters

CCHFContentHandler &aSource

The content handler that called this function

TInt aErrorCode

The error code


HandleDrawRequestL()

virtual void HandleDrawRequestL(CCHFContentHandler &aRequester)=0;

Description

Handles a request to draw from a content handler.

The request may be handled immediately or it may be queued or silently refused by the parent. Content handlers may call this to indicate they they should be redrawn because their contents have changed.

Parameters

CCHFContentHandler &aRequester

The content handler that made the request


HandleResizeRequestL()

virtual void HandleResizeRequestL(CCHFContentHandler &aRequester, TRect aRequestedSize)=0;

Description

Handles a resize request from a content handler. The request may be handled immediately or it may be queued or silently refused by the parent.

Parameters

CCHFContentHandler &aRequester

The content handler that made the request

TRect aRequestedSize

The new size of the content handler. This may also be used to request that the embedded content handler be moved by changing the top left of aRequestedSize.


HandleGenericRequestL()

virtual TInt HandleGenericRequestL(CCHFContentHandler &aRequester, const TCHFMessage &aRequestMessage, TCHFValue &aRequestResponse)=0;

Description

Handle a generic request from a content handler.

Parameters

CCHFContentHandler &aRequester

The content handler that made the request

const TCHFMessage &aRequestMessage

A message containing a category of request, a numeric code identifier to uniquely identify the request within the specified category and a TCHFValue where the type is governed by the category and numeric code of the request. All parents should respond to the category of messages KCHFRequestMessageUid. Others may be added and if the category UID is not one that is supported, then the function should return KErrNotSupported.

TCHFValue &aRequestResponse

A value that can be filled in. The type of this should be specified along with the request code. This may be left unchanged if the request requires no immediate response

Return value

TInt

TInt KErrNone if the request was accepted and handled. KErrNotSupported if the request is one that is not understood or not supported. Other specific error codes that are specified by content handlers or applications.


MCHFParent_Reserved_1()

private: virtual IMPORT_C void MCHFParent_Reserved_1();

Description


MCHFParent_Reserved_2()

private: virtual IMPORT_C void MCHFParent_Reserved_2();

Description


MCHFParent_Reserved_3()

private: virtual IMPORT_C void MCHFParent_Reserved_3();

Description


MCHFParent_Reserved_4()

private: virtual IMPORT_C void MCHFParent_Reserved_4();

Description