2 // Open Service Platform
3 // Copyright (c) 2012-2013 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 FUiISlidableListEventListener.h
20 * @brief This is the header file for the %ISlidableListEventListener interface.
22 * This header file contains the declarations of the %ISlidableListEventListener interface. @n
23 * If the event is generated, a method of this interface is called. @n
24 * So, if applications do jobs related to item events, use the methods of this interface.
27 #ifndef _FUI_ISLIDABLE_LIST_EVENT_LISTENER_H_
28 #define _FUI_ISLIDABLE_LIST_EVENT_LISTENER_H_
30 #include <FBaseRtIEventListener.h>
32 namespace Tizen { namespace Ui
37 namespace Tizen {namespace Ui
42 * @interface ISlidableListEventListener
43 * @brief <i> [Deprecated] </i> This interface implements the listener for events on SlidableList.
44 * @deprecated This interface is deprecated. Instead of using this interface, use the IListViewItemEventListener interface.
48 * The %ISlidableListEventListener interface implements a listener for receiving scroll events on SlidableList. This listener is implemented
49 * to allow the application to load the items as needed, as the user scrolls through the list.
50 * The class is registered with a SlidableList, using the control's AddSlidableListEventListener() method.
53 class _OSP_EXPORT_ ISlidableListEventListener
54 : public Tizen::Base::Runtime::IEventListener
60 * This is the destructor for this class.
62 * @brief <i> [Deprecated] </i> This interface implements the listener for events on SlidableList.
63 * @deprecated This interface is deprecated. Instead of using this interface, use the IListViewItemEventListener interface.
67 virtual ~ISlidableListEventListener(void) {}
71 * Called when the slidable list is about to be drawn and requests to set the properties of the list such as the total height.
73 * @brief <i> [Deprecated] </i> This interface implements the listener for events on SlidableList.
74 * @deprecated This interface is deprecated. Instead of using this interface, use the IListViewItemEventListener interface.
77 * @param[in] source The source of the event
80 virtual void OnListPropertyRequested(const Tizen::Ui::Control& source) = 0;
84 * Called when the items need to be loaded to the top.
86 * @brief <i> [Deprecated] </i> This interface implements the listener for events on SlidableList.
87 * @deprecated This interface is deprecated. Instead of using this interface, use the IListViewItemEventListener interface.
90 * @param[in] source The source of the event
91 * @param[in] index The index of the item
92 * @param[in] numItems The number of items
95 virtual void OnLoadToTopRequested(const Tizen::Ui::Control& source, int index, int numItems) = 0;
99 * Called when the items need to be loaded to the bottom.
101 * @brief <i> [Deprecated] </i> This interface implements the listener for events on SlidableList.
102 * @deprecated This interface is deprecated. Instead of using this interface, use the IListViewItemEventListener interface.
105 * @param[in] source The source of the event
106 * @param[in] index The index of the item
107 * @param[in] numItems The number of items
110 virtual void OnLoadToBottomRequested(const Tizen::Ui::Control& source, int index, int numItems) = 0;
114 * Called when an item is about to be unloaded from memory. @n
115 * The user-allocated resources associated with the item must be freed before unloading, when OnUnloadItemRequested() is called.
117 * @brief <i> [Deprecated] </i> This interface implements the listener for events on SlidableList.
118 * @deprecated This interface is deprecated. Instead of using this interface, use the IListViewItemEventListener interface.
121 * @param[in] source The source of the event
122 * @param[in] index The index of the item
125 virtual void OnUnloadItemRequested(const Tizen::Ui::Control& source, int index) = 0;
127 }; //ISlidableListEventListener
131 #endif // _FUI_ISLIDABLE_LIST_EVENT_LISTENER_H_