Merge "Fix bug[N_SE-37282]" into tizen_2.1
[platform/framework/native/uifw.git] / inc / FUiCtrlIExpandableEditAreaEventListener.h
1 //
2 // Open Service Platform
3 // Copyright (c) 2012-2013 Samsung Electronics Co., Ltd.
4 //
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
8 //
9 //     http://www.apache.org/licenses/LICENSE-2.0/
10 //
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.
16 //
17 /**
18  * @file        FUiCtrlIExpandableEditAreaEventListener.h
19  * @brief       This is the header file for the %IExpandableEditAreaEventListener interface.
20  *
21  * This header file contains the declarations of the %IExpandableEditAreaEventListener interface.
22  */
23 #ifndef _FUI_CTRL_IEXPANDABLE_EDIT_AREA_EVENT_LISTENER_H_
24 #define _FUI_CTRL_IEXPANDABLE_EDIT_AREA_EVENT_LISTENER_H_
25
26 // includes
27 #include <FBaseRtIEventListener.h>
28 #include <FUiCtrlExpandableEditArea.h>
29
30 namespace Tizen { namespace Ui
31 {
32 class Control;
33 } } // Tizen::Ui
34
35 // namespace declaration
36 namespace Tizen { namespace Ui { namespace Controls
37 {
38  /**
39   * @interface  IExpandableEditAreaEventListener
40   * @brief          This interface defines a listener for the %ExpandableEditArea events.
41   *
42   * @since          2.0
43   *
44   * The %IExpandableEditAreaEventListener interface is the listener interface for receiving %ExpandableEditArea events.
45   *
46   * For more information on the class features,
47   * see <a href="../org.tizen.native.appprogramming/html/guide/ui/implementing_exp_editarea.htm">ExpandableEditArea</a>.
48   *
49   */
50 class _OSP_EXPORT_ IExpandableEditAreaEventListener
51         : public Tizen::Base::Runtime::IEventListener
52 {
53
54 // Lifecycle
55 public:
56         /**
57          * This is the destructor for this class.
58          *
59          * @since        2.0
60          */
61         virtual ~IExpandableEditAreaEventListener(void) {}
62
63
64 // Operations
65 public:
66         /**
67          * Called when a new line is added to ExpandableEditArea.
68          *
69          * @since       2.0
70          *
71          * @param[in]   source          The source of the event
72          * @param[in]   newLineCount    The new line count
73          */
74         virtual void OnExpandableEditAreaLineAdded(Tizen::Ui::Controls::ExpandableEditArea& source, int newLineCount) = 0;
75
76         /**
77          * Called when a line is removed from ExpandableEditArea.
78          *
79          * @since       2.0
80          *
81          * @param[in]   source          The source of the event
82          * @param[in]   newLineCount    The new line count
83          */
84         virtual void OnExpandableEditAreaLineRemoved(Tizen::Ui::Controls::ExpandableEditArea& source, int newLineCount) = 0;
85
86
87 // Reserves
88 protected:
89         //
90         // This method is for internal use only.
91         // Using this method can cause behavioral, security-related, and consistency-related issues in the application.
92         //
93         //       This method is reserved and may change its name at any time without prior notice.
94         //
95         //       @since      2.0
96         //
97         virtual void IExpandableEditAreaEventListener_Reserved1(void) { }
98
99         //
100         // This method is for internal use only.
101         // Using this method can cause behavioral, security-related, and consistency-related issues in the application.
102         //
103         //       This method is reserved and may change its name at any time without prior notice.
104         //
105         //       @since      2.0
106         //
107         virtual void IExpandableEditAreaEventListener_Reserved2(void) { }
108
109         //
110         // This method is for internal use only.
111         // Using this method can cause behavioral, security-related, and consistency-related issues in the application.
112         //
113         //       This method is reserved and may change its name at any time without prior notice.
114         //
115         //       @since      2.0
116         //
117         virtual void IExpandableEditAreaEventListener_Reserved3(void) { }
118 };  // IExpandableEditAreaEventListener
119
120 }}} // Tizen::Ui::Controls
121
122 #endif //_FUI_CTRL_IEXPANDABLE_EDIT_AREA_EVENT_LISTENER_H_