2 // Open Service Platform
\r
3 // Copyright (c) 2012 Samsung Electronics Co., Ltd.
\r
5 // Licensed under the Apache License, Version 2.0 (the License);
\r
6 // you may not use this file except in compliance with the License.
\r
7 // You may obtain a copy of the License at
\r
9 // http://www.apache.org/licenses/LICENSE-2.0
\r
11 // Unless required by applicable law or agreed to in writing, software
\r
12 // distributed under the License is distributed on an "AS IS" BASIS,
\r
13 // WITHOUT WARRANTIES OR CONDITIONS OF ANY KIND, either express or implied.
\r
14 // See the License for the specific language governing permissions and
\r
15 // limitations under the License.
\r
19 * @file FWebCtrlIWebUiEventListenerF.h
\r
20 * @brief This is the header file for the %IWebUiEventListenerF interface.
\r
22 * This header file contains the declarations of the %IWebUiEventListenerF interface.
\r
24 #ifndef _FWEB_CTRL_IWEB_UI_EVENT_LISTENER_F_H
\r
25 #define _FWEB_CTRL_IWEB_UI_EVENT_LISTENER_F_H_
\r
27 #include <FBaseRtIEventListener.h>
\r
28 #include <FWebCtrlWeb.h>
\r
29 #include <FGrpPoint.h>
\r
31 namespace Tizen { namespace Web { namespace Controls
\r
35 * @interface IWebUiEventListenerF
\r
36 * @brief This interface is used for receiving user interface (UI) related events caused by the layout changes of a control.
\r
40 * The %IWebUiEventListenerF interface is used for receiving user interface (UI) related events caused by the layout changes of a control.
\r
41 * The browser engine requests a screen update through this interface when the layout of a page is changed.
\r
43 class _OSP_EXPORT_ IWebUiEventListenerF
\r
44 : public virtual Tizen::Base::Runtime::IEventListener
\r
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.
\r
52 virtual ~IWebUiEventListenerF (void) {}
\r
55 * Called when the layout of a page is updated. @n
\r
56 * The application must call Tizen::Ui::Control::Show() if the screen needs to be updated.
\r
60 * @param[in] source The source of the event
\r
62 virtual void OnWebPageShowRequested(Tizen::Web::Controls::Web& source) = 0;
\r
65 * Called when a request for creating a new window is received. @n
\r
66 * The returned %Web control instance must be constructed by using a child window's Construct() method.
\r
70 * @return A pointer to the new WebWindow instance
\r
72 virtual Tizen::Web::Controls::Web* OnWebWindowCreateRequested(void) = 0;
\r
75 * Called when a request for closing the window is received. @n
\r
76 * This event is called from the parent window's listener that invoked the child window. @n
\r
77 * The application must free the resource allocated for the %Web Control.
\r
81 * @param[in] source The source of the closing event
\r
83 virtual void OnWebWindowCloseRequested(Tizen::Web::Controls::Web& source) = 0;
\r
86 * Called when the selected block of a page is updated.
\r
90 * @param[in] source The source of the event
\r
91 * @param[in] startPoint The starting point of the selected block
\r
92 * @param[in] endPoint The ending point of the selected block
\r
94 virtual void OnWebPageBlockSelected(Tizen::Web::Controls::Web& source, Tizen::Graphics::FloatPoint& startPoint, Tizen::Graphics::FloatPoint& endPoint) = 0;
\r
97 * Called just after touch move event whether preventDefault() method is triggered or not. @n
\r
98 * The application which wants to support W3C preventDefault() feature is recommended to use this callback and delay to handle touch move event until receiving this callback if needed.
\r
102 * @param[in] source The source of the event
\r
103 * @param[in] trigger Set to @c true if the preventDefault() method is triggered, @n
\r
105 * @remarks This callback is always called just after touch move event and return true when preventDefault() is triggered on touch start or touch move event.
\r
107 virtual void OnWebPreventDefaultTriggered(Tizen::Web::Controls::Web& source, bool trigger) {};
\r
111 // This method is for internal use only. Using this method can cause behavioral, security-related, and consistency-related issues in the application.
\r
113 // Gets the Impl instance.
\r
117 virtual void IWebUiEventListenerF_Reserved1(void) {};
\r
120 // This method is for internal use only. Using this method can cause behavioral, security-related, and consistency-related issues in the application.
\r
122 // Gets the Impl instance.
\r
126 virtual void IWebUiEventListenerF_Reserved2(void) {};
\r
129 // This method is for internal use only. Using this method can cause behavioral, security-related, and consistency-related issues in the application.
\r
131 // Gets the Impl instance.
\r
135 virtual void IWebUiEventListenerF_Reserved3(void) {};
\r
138 // This method is for internal use only. Using this method can cause behavioral, security-related, and consistency-related issues in the application.
\r
140 // Gets the Impl instance.
\r
144 virtual void IWebUiEventListenerF_Reserved4(void) {};
\r
145 }; // IWebUiEventListenerF
\r
147 }}} // Tizen::Web::Controls
\r
148 #endif // _FWEB_CTRL_IWEB_UI_EVENT_LISTENER_F_H_
\r