Merge "remove unnecessary implementations" into tizen_2.1
[platform/framework/native/appfw.git] / inc / FSysIChargingEventListener.h
1 //
2 // Open Service Platform
3 // Copyright (c) 2012 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 /**
19  * @file        FSysIChargingEventListener.h
20  * @brief       This is the header file for the %IChargingEventListener interface.
21  *
22  * This header file contains the declarations of the %IChargingEventListener interface.
23  */
24
25 #ifndef _FSYS_ICHARGING_EVENT_LISTENER_H_
26 #define _FSYS_ICHARGING_EVENT_LISTENER_H_
27
28 #include <FBaseResult.h>
29 #include <FBaseRtIEventListener.h>
30
31 namespace Tizen { namespace System
32 {
33
34 /**
35  * @interface   IChargingEventListener
36  * @brief       This interface is the listener of the charging event.
37  * @since 2.0
38  *
39  * The %IChargingEventListener interface must be registered and implemented by an application to
40  * receive events from the system when the device charging state changes.
41  *
42  */
43 class _OSP_EXPORT_ IChargingEventListener
44         : public virtual Tizen::Base::Runtime::IEventListener
45 {
46 public:
47         /**
48          * This is the destructor for this class. 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.
49          *
50          * @since 2.0
51          */
52         virtual ~IChargingEventListener(void) {}
53
54         /**
55          * Called when the charging state is changed.
56          *
57          * @since 2.0
58          *
59          * @param[in]   charging        The charging state
60          */
61         virtual void OnChargingStateChanged(bool charging) = 0;
62
63 protected:
64         //
65         // This method is for internal use only.
66         // Using this method can cause behavioral, security-related, and consistency-related issues in the application.
67         //
68         // @since 2.0
69         virtual void OnIChargingEventListener_Reserved1(void) {}
70
71         //
72         // This method is for internal use only.
73         // Using this method can cause behavioral, security-related, and consistency-related issues in the application.
74         //
75         // @since 2.0
76         virtual void OnIChargingEventListener_Reserved2(void) {}
77
78         //
79         // This method is for internal use only.
80         // Using this method can cause behavioral, security-related, and consistency-related issues in the application.
81         //
82         // @since 2.0
83         virtual void OnIChargingEventListener_Reserved3(void) {}
84
85 }; // IChargingEventListener
86
87 } } // Tizen::System
88
89 #endif // _FSYS_ICHARGING_EVENT_LISTENER_H_