Revise Tizen::Io doxygen
[platform/framework/native/appfw.git] / inc / FSysIBootEventListener.h
1 //
2 // Copyright (c) 2012 Samsung Electronics Co., Ltd.
3 //
4 // Licensed under the Apache License, Version 2.0 (the License);
5 // you may not use this file except in compliance with the License.
6 // You may obtain a copy of the License at
7 //
8 //     http://www.apache.org/licenses/LICENSE-2.0
9 //
10 // Unless required by applicable law or agreed to in writing, software
11 // distributed under the License is distributed on an "AS IS" BASIS,
12 // WITHOUT WARRANTIES OR CONDITIONS OF ANY KIND, either express or implied.
13 // See the License for the specific language governing permissions and
14 // limitations under the License.
15 //
16
17 /**
18  * @file        FSysIBootEventListener.h
19  * @brief       This is the header file for the %IBootEventListener interface.
20  *
21  * This header file contains the declarations of the %IBootEventListener interface.
22  */
23
24 #ifndef _FSYS_IBOOT_EVENT_LISTENER_H_
25 #define _FSYS_IBOOT_EVENT_LISTENER_H_
26
27 #include <FBaseResult.h>
28 #include <FBaseRtIEventListener.h>
29
30 namespace Tizen { namespace System
31 {
32
33 /**
34  * @interface   IBootEventListener
35  * @brief               This interface is the listener of the boot event.
36  *
37  * @since 2.1
38  *
39  * The %IBootEventListener interface must be registered and implemented by an application to receive boot events from the system.
40  *
41  */
42 class _OSP_EXPORT_ IBootEventListener
43         : public virtual Tizen::Base::Runtime::IEventListener
44 {
45 public:
46         /**
47          * This is the destructor for this class. @n
48          * This polymorphic destructor should be overridden if required. @n
49          * This way, the destructors of the derived classes are called when the destructor of this interface is called.
50          *
51          * @since 2.1
52          */
53         virtual ~IBootEventListener(void) {}
54         /**
55          * Called after the system has finished booting.
56          *
57          * @since       2.1
58          */
59         virtual void OnBootCompleted(void) = 0;
60
61 protected:
62         //
63         // This method is for internal use only.
64         // Using this method can cause behavioral, security-related, and consistency-related issues in the application.
65         //
66         // @since 2.1
67         virtual void OnIBootEventListener_Reserved1(void) {}
68
69         //
70         // This method is for internal use only.
71         // Using this method can cause behavioral, security-related, and consistency-related issues in the application.
72         //
73         // @since 2.1
74         virtual void OnIBootEventListener_Reserved2(void) {}
75
76         //
77         // This method is for internal use only.
78         // Using this method can cause behavioral, security-related, and consistency-related issues in the application.
79         //
80         // @since 2.1
81         virtual void OnIBootEventListener_Reserved3(void) {}
82
83 }; // IBootEventListener
84
85 } } // Tizen::System
86
87 #endif // _FSYS_IBOOT_EVENT_LISTENER_H_