diff -r 666f914201fb -r 2fe1408b6811 epoc32/include/mw/brctlwindowobserver.h --- a/epoc32/include/mw/brctlwindowobserver.h Tue Nov 24 13:55:44 2009 +0000 +++ b/epoc32/include/mw/brctlwindowobserver.h Tue Mar 16 16:12:26 2010 +0000 @@ -1,1 +1,98 @@ -brctlwindowobserver.h +/* +* Copyright (c) 2006 Nokia Corporation and/or its subsidiary(-ies). +* All rights reserved. +* This component and the accompanying materials are made available +* under the terms of the License "Eclipse Public License v1.0" +* which accompanies this distribution, and is available +* at the URL "http://www.eclipse.org/legal/epl-v10.html". +* +* Initial Contributors: +* Nokia Corporation - initial contribution. +* +* Contributors: +* +* Description: Handle multiple windows events such as open/close/etc +* +*/ + + +#ifndef BRCTLWINDOWOBSERVER_H +#define BRCTLWINDOWOBSERVER_H + +// INCLUDES +#include +#include +#include + +// CONSTANTS + +// MACROS + +// DATA TYPES +enum TBrCtlWindowCommand + { + EFocusWindow, + EUnfocusWindow, + EShowWindow, + ECloseWindow + }; + +// FUNCTION PROTOTYPES + +// FORWARD DECLARATIONS +class CBrCtlInterface; + +/** +* The MBrCtlWindowObserver class handles window events such open/close/etc +* +* Usage: +* +* @code +* #include +* +* @see S60 Platform: Browser Control API Developer's Guide Version 2.0 +* @lib BrowserEngine.lib +* @since 3.0 +* @file BrCtlWindowObserver.h +* @endcode * +*/ +class MBrCtlWindowObserver + { + public: // New functions + /** + * Request the host applicaion to open the URL in a new window + * @since 3.0 + * @param aUrl The Url of the request to be done in the new window + * @param aTargetName The name of the new window + * @param aUserInitiated ETrue if the new window is initiated by a user event (click) + * @param aMethod The method to be used for fetching the supplied url + * @param aContentType If the method is POST, this is the content type of the data to be posted + * @param aPostData If the method is POST, this is the data to be posted + * @param aBoundary The boundary used if the content is multipart/form-data + * @param aReserved For future use + * @return Return Value is the new browser control associated with the new window + */ + virtual CBrCtlInterface* OpenWindowL(TDesC& aUrl, TDesC* aTargetName, TBool aUserInitiated, + TAny* aReserved) = 0; + + /** + * Find a window by target name + * @since 3.0 + * @param aTargetName name of the window to find + * @return Return Value is the browser control associated with the window name + */ + virtual CBrCtlInterface* FindWindowL( const TDesC& aTargetName ) const = 0; + + /** + * Handle window events such as close/focus etc + * @since 3.0 + * @param aTargetName name of the window to send the event to + * @param aCommand Command to pass to the window + * @return void + */ + virtual void HandleWindowCommandL( const TDesC& aTargetName, TBrCtlWindowCommand aCommand ) = 0; + }; + +#endif // BRCTLWINDOWOBSERVER_H + +// End of File