2 // Copyright (c) 2012 Samsung Electronics Co., Ltd.
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
8 // http://www.apache.org/licenses/LICENSE-2.0
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.
18 * @file FSysISettingEventListener.h
19 * @brief This is the header file for the %ISettingEventListener interface.
21 * This header file contains the declarations of the %ISettingEventListener interface.
24 #ifndef _FSYS_ISETTING_EVENT_LISTENER_H_
25 #define _FSYS_ISETTING_EVENT_LISTENER_H_
27 #include <FBaseResult.h>
28 #include <FBaseRtIEventListener.h>
30 namespace Tizen { namespace System
34 * @interface ISettingEventListener
35 * @brief This interface is the listener of the setting event.
39 * The %ISettingEventListener interface must be registered and implemented by an application to receive setting events from the system.
42 class _OSP_EXPORT_ ISettingEventListener
43 : public virtual Tizen::Base::Runtime::IEventListener
47 * This is the destructor for this class. @n
48 * This polymorphic destructor should be overridden if required. @n This way,
49 * the destructors of the derived classes are called when the destructor of this interface is called.
53 virtual ~ISettingEventListener(void) {}
55 * Called when a setting value has been changed.
59 * @param[in] key The key name of the changed setting information
60 * @remarks Invokes one of the overloaded getter methods of Tizen::System::SettingInfo to get the changed value
61 * corresponding to the given key.
63 virtual void OnSettingChanged(Tizen::Base::String& key) = 0;
67 // This method is for internal use only.
68 // Using this method can cause behavioral, security-related, and consistency-related issues in the application.
71 virtual void OnISettingEventListener_Reserved1(void) {}
74 // This method is for internal use only.
75 // Using this method can cause behavioral, security-related, and consistency-related issues in the application.
78 virtual void OnISettingEventListener_Reserved2(void) {}
81 // This method is for internal use only.
82 // Using this method can cause behavioral, security-related, and consistency-related issues in the application.
85 virtual void OnISettingEventListener_Reserved3(void) {}
87 }; // ISettingEventListener
91 #endif // _FSYS_ISETTING_EVENT_LISTENER_H_