2 // Open Service Platform
3 // Copyright (c) 2012 Samsung Electronics Co., Ltd.
5 // Licensed under the Apache License, Version 2.0 (the License);
6 // you may not use this file except in compliance with the License.
7 // You may obtain a copy of the License at
9 // http://www.apache.org/licenses/LICENSE-2.0
11 // Unless required by applicable law or agreed to in writing, software
12 // distributed under the License is distributed on an "AS IS" BASIS,
13 // WITHOUT WARRANTIES OR CONDITIONS OF ANY KIND, either express or implied.
14 // See the License for the specific language governing permissions and
15 // limitations under the License.
19 * @file FWebCtrlIWebUiEventListener.h
20 * @brief This is the header file for the %IWebUiEventListener interface.
22 * This header file contains the declarations of the %IWebUiEventListener interface.
24 #ifndef _FWEB_CTRL_IWEB_UI_EVENT_LISTENER_H_
25 #define _FWEB_CTRL_IWEB_UI_EVENT_LISTENER_H_
27 #include <FBaseRtIEventListener.h>
28 #include <FWebCtrlWeb.h>
29 #include <FGrpPoint.h>
31 namespace Tizen { namespace Web { namespace Controls
35 * @interface IWebUiEventListener
36 * @brief This interface is used for receiving user interface (UI) related events caused by the layout changes of a control.
40 * The %IWebUiEventListener interface is used for receiving user interface (UI) related events caused by the layout changes of a control.
41 * The browser engine requests a screen update through this interface when the layout of a page is changed.
43 class _OSP_EXPORT_ IWebUiEventListener
44 : public virtual Tizen::Base::Runtime::IEventListener
48 * This polymorphic destructor should be overridden if required. This way, the destructors of the derived classes are called when the destructor of this interface is called.
52 virtual ~IWebUiEventListener(void) {}
55 * Called when the layout of a page is updated. @n
56 * The application must call Control::Show() if the screen needs to be updated.
60 * @param[in] source The source of the event
62 virtual void OnWebPageShowRequested(Tizen::Web::Controls::Web& source) = 0;
66 * Called when a request for creating a new window is received. @n
67 * The returned Web control instance must be constructed by using a child window's Construct() method.
71 * @return A pointer to the new WebWindow instance
73 virtual Tizen::Web::Controls::Web* OnWebWindowCreateRequested(void) = 0;
77 * Called when a request for closing the window is received. @n
78 * This event is called from the parent window's listener that invoked the child window. @n
79 * The application must free the resource allocated for the Web Control.
83 * @param[in] source The source of the closing event
85 virtual void OnWebWindowCloseRequested(Tizen::Web::Controls::Web& source) = 0;
88 * Called when the selected block of a page is updated.
92 * @param[in] source The source of the event
93 * @param[in] startPoint The starting point of the selected block
94 * @param[in] endPoint The ending point of the selected block
96 virtual void OnWebPageBlockSelected(Tizen::Web::Controls::Web& source, Tizen::Graphics::Point& startPoint, Tizen::Graphics::Point& endPoint) = 0;
101 // This method is for internal use only. Using this method can cause behavioral, security-related, and consistency-related issues in the application.
103 // Gets the Impl instance.
107 virtual void IWebUiEventListener_Reserved1(void) {};
110 // This method is for internal use only. Using this method can cause behavioral, security-related, and consistency-related issues in the application.
112 // Gets the Impl instance.
116 virtual void IWebUiEventListener_Reserved2(void) {};
119 // This method is for internal use only. Using this method can cause behavioral, security-related, and consistency-related issues in the application.
121 // Gets the Impl instance.
125 virtual void IWebUiEventListener_Reserved3(void) {};
128 // This method is for internal use only. Using this method can cause behavioral, security-related, and consistency-related issues in the application.
130 // Gets the Impl instance.
134 virtual void IWebUiEventListener_Reserved4(void) {};
137 // This method is for internal use only. Using this method can cause behavioral, security-related, and consistency-related issues in the application.
139 // Gets the Impl instance.
143 virtual void IWebUiEventListener_Reserved5(void) {};
144 }; // IWebUiEventListener
146 }}} // Tizen::Web::Controls
147 #endif // _FWEB_CTRL_IWEB_UI_EVENT_LISTENER_H_