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(CCHFContentHandler &)Handles a request to draw from a content handler.
• HandleError(CCHFContentHandler &,TInt)Handles errors from a content handler.
• HandleGenericRequestL(CCHFContentHandler &,const TCHFMessage &,TCHFValue &)Handle a generic request from a content handler.
• HandleResizeRequestL(CCHFContentHandler &,TRect)Handles a resize request from a content handler. The request may be handled imme...
• MCHFParent_Reserved_1()
• MCHFParent_Reserved_2()
• MCHFParent_Reserved_3()
• MCHFParent_Reserved_4()
• ResolveUriL(CCHFContentHandler &,const TDesC8 &)Resolves relative URIs.

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

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

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

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.

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.

private: IMPORT_C virtual void MCHFParent_Reserved_1();

Description

private: IMPORT_C virtual void MCHFParent_Reserved_2();

Description

private: IMPORT_C virtual void MCHFParent_Reserved_3();

Description

private: IMPORT_C virtual void MCHFParent_Reserved_4();

Description