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 FUiCtrlEditTime.h
20 * @brief This is the header file for the %EditTime class.
22 * This header file contains the declarations of the %EditTime class.
24 #ifndef _FUI_CTRL_EDIT_TIME_H_
25 #define _FUI_CTRL_EDIT_TIME_H_
27 #include <FUiControl.h>
28 #include <FUiITimeChangeEventListener.h>
29 #include <FUiIOrientationEventListener.h>
31 namespace Tizen { namespace Ui { namespace Controls
36 * @brief This class defines the common behavior of an %EditTime control.
40 * The %EditTime class displays a small, fixed-size selector that allows the user to select a time.
41 * Unlike TimePicker, %EditTime can be placed in a container.
43 * For more information on the class features, see
44 * <a href="../org.tizen.native.appprogramming/html/guide/ui/implementing_edittime_editdate.htm">EditDate and EditTime</a>.
46 * The following example demonstrates how to use the %EditTime class.
49 // Sample code for EditTimeSample.h
53 : public Tizen::Ui::Controls::Form
54 , public Tizen::Ui::ITimeChangeEventListener
60 bool Initialize(void);
61 virtual result OnInitializing(void);
63 // ITimeChangeEventListener
64 virtual void OnTimeChanged(const Tizen::Ui::Control& source, int hour, int minute);
65 virtual void OnTimeChangeCanceled(const Tizen::Ui::Control& source);
68 Tizen::Ui::Controls::EditTime* __pEditTime;
73 // Sample code for EditTimeSample.cpp
74 #include <FGraphics.h>
76 #include "EditTimeSample.h"
78 using namespace Tizen::Graphics;
79 using namespace Tizen::Ui::Controls;
82 EditTimeSample::Initialize(void)
84 Construct(FORM_STYLE_NORMAL);
89 EditTimeSample::OnInitializing(void)
93 // Creates an instance of EditTime
94 __pEditTime = new EditTime();
95 __pEditTime->Construct(Point(100, 100));
96 __pEditTime->AddTimeChangeEventListener(*this);
98 //Adds the edit time to the form
99 AddControl(*__pEditTime);
104 // ITimeChangeEventListener implementation
106 EditTimeSample::OnTimeChanged(const Control& source, int hour, int minute)
112 EditTimeSample::OnTimeChangeCanceled(const Control& source)
118 class _OSP_EXPORT_ EditTime
119 : public Tizen::Ui::Control
123 * The object is not fully constructed after this constructor is called. @n
124 * For full construction, the %Construct() method must be called right after calling this constructor.
131 * This polymorphic destructor should be overridden if required.@n
132 * This way, the destructors of the derived classes are called when the destructor of this interface is called.
136 virtual ~EditTime(void);
139 * Adds a time changed event listener instance.
143 * @param[in] listener The listener to add
144 * @see ITimeChangeEventListener::OnTimeChanged()
145 * @see ITimeChangeEventListener::OnTimeChangeCanceled()
146 * @see RemoveTimeChangeEventListener()
148 void AddTimeChangeEventListener(Tizen::Ui::ITimeChangeEventListener& listener);
151 * Removes a listener instance. @n
152 * The removed listener cannot listen to events when they are fired.
156 * @param[in] listener The listener to remove
157 * @see AddTimeChangeEventListener()
159 void RemoveTimeChangeEventListener(Tizen::Ui::ITimeChangeEventListener& listener);
162 * Initializes this instance of %EditTime with the specified parameters.
166 * @return An error code
167 * @param[in] point The position of %EditTime in container @n
168 * The optimal size of the control is defined in
169 * <a href="../org.tizen.native.appprogramming/html/guide/ui/control_optimalsize.htm">Optimal Size of UI Controls</a>.
170 * @param[in] title The title
171 * @exception E_SUCCESS The method is successful.
172 * @exception E_SYSTEM A system error has occurred.
174 result Construct(const Tizen::Graphics::Point& point, const Tizen::Base::String& title = L"");
177 * Initializes this instance of %EditTime with the specified parameters.
181 * @return An error code
182 * @param[in] point The position of %EditTime in container @n
183 * The optimal size of the control is defined in
184 * <a href="../org.tizen.native.appprogramming/html/guide/ui/control_optimalsize.htm">Optimal Size of UI Controls</a>.
185 * @param[in] title The title
186 * @exception E_SUCCESS The method is successful.
187 * @exception E_SYSTEM A system error has occurred.
189 result Construct(const Tizen::Graphics::FloatPoint& point, const Tizen::Base::String& title = L"");
192 * Gets the current hour value of the %EditTime control.
196 * @return The current hour value. @n
197 * The hour value is between @c 0 to @c 23.
199 * @remarks The default hour value is the current system hour.
201 int GetHour(void) const;
204 * Gets the current minute value of the %EditTime control.
208 * @return The current minute value
210 * @remarks The default minute value is the current system minute.
212 int GetMinute(void) const;
215 * Gets the current time value of the %EditTime control.
219 * @return The time value
221 Tizen::Base::DateTime GetTime(void) const;
224 * Sets the 12-hour or 24-hour display type of the %EditTime. @n
225 * This can be 12-hour or 24-hour type.
229 * @param[in] enable Set to @c true to set the 24-hour notation, @n
230 * else @c false to set the 12-hour notation
232 void Set24HourNotationEnabled(bool enable);
235 * Sets the hour value of the %EditTime control. @n
236 * The hour value should be between @c 0 and @c 23.
240 * @param[in] hour The hour value to set
241 * @exception E_SUCCESS The method is successful.
242 * @exception E_INVALID_ARG The specified hour value is invalid.
243 * @exception E_SYSTEM A system error has occurred.
246 result SetHour(int hour);
249 * Sets the minute value of the %EditTime control. @n
250 * The minute value should be between @c 0 and @c 59.
254 * @param[in] minute The minute value to set
255 * @exception E_SUCCESS The method is successful.
256 * @exception E_INVALID_ARG The specified minute value is invalid.
257 * @exception E_SYSTEM A system error has occurred.
260 result SetMinute(int minute);
263 * Sets the designated time value of the %EditTime control.
267 * @param[in] time The time to set
269 void SetTime(const Tizen::Base::DateTime& time);
272 * Sets the value of the %EditTime control using the current system time.
276 void SetCurrentTime(void);
279 * Enables TimePicker.
283 * @param[in] enable Set to @c true to enable %TimePicker, @n
286 void SetTimePickerEnabled(bool enable);
289 * Checks whether TimePicker is enabled.
293 * @return @c true if TimePicker is enabled, @n
296 bool IsTimePickerEnabled(void) const;
300 // The implementation of this copy constructor is intentionally blank and declared as private to prohibit copying of objects.
302 EditTime(const EditTime& rhs);
305 // The implementation of this copy assignment operator is intentionally blank and declared as private to prohibit copying of objects.
307 EditTime& operator =(const EditTime& rhs);
309 friend class _EditTimeImpl;
312 }}} //Tizen::Ui::Controls
314 #endif // _FUI_CTRL_EDIT_TIME_H_