2 // Open Service Platform
3 // Copyright (c) 2012-2013 Samsung Electronics Co., Ltd.
5 // Licensed under the Flora License, Version 1.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://floralicense.org/license/
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 FShellAppWidgetFrame.h
20 * @brief This is the header file for the %AppWidgetFrame class.
22 * This header file contains the declarations of the %AppWidgetFrame class.
25 #ifndef _FSHELL_APPWIDGET_FRAME_H_
26 #define _FSHELL_APPWIDGET_FRAME_H_
28 #include <FUiWindow.h>
30 namespace Tizen { namespace Shell
34 * @class AppWidgetFrame
35 * @brief This class provides the main frame window for a AppWidgetProvider.
38 * The %AppWidgetFrame is the root parent of all AppWidget controls that are created by a AppWidgetProvider.
41 class _OSP_EXPORT_ AppWidgetFrame
42 : public Tizen::Ui::Window
46 * The object is not fully constructed after this constructor is called.
47 * For full construction, the Construct() method must be called after calling this constructor.
54 * This destructor overrides Tizen::Base::Object::~Object().
58 virtual ~AppWidgetFrame(void);
61 * Initializes this instance of %AppWidgetFrame with the specified parameter.
64 * @feature %http://tizen.org/feature/shell.appwidget
65 * @return An error code
66 * @param[in] size The new width and height
67 * @exception E_SUCCESS The method is successful.
68 * @exception E_INVALID_ARG A specified input parameter is invalid.
69 * @exception E_UNSUPPORTED_OPERATION The Emulator or target device does not support the required feature.
\r
70 * For more information, see <a href="../org.tizen.gettingstarted/html/tizen_overview/application_filtering.htm">Application Filtering</a>.
\r
71 * remarks Before calling this method, check whether the feature is supported by %Tizen::System::SystemInfo::GetValue() methods.
72 * @see AppWidgetProvider::OnAppWidgetProviderInitialize()
74 result Construct(const Tizen::Graphics::FloatDimension& size);
77 * Initializes this instance of %AppWidgetFrame with the specified parameter.
80 * @feature %http://tizen.org/feature/shell.appwidget
81 * @return An error code
82 * @param[in] layout The layout for both the portrait and landscape mode
83 * @param[in] size The new width and height
84 * @exception E_SUCCESS The method is successful.
85 * @exception E_INVALID_ARG A specified input parameter is invalid.
86 * @exception E_UNSUPPORTED_OPERATION The Emulator or target device does not support the required feature.
\r
87 * For more information, see <a href="../org.tizen.gettingstarted/html/tizen_overview/application_filtering.htm">Application Filtering</a>.
\r
88 * remarks Before calling this method, check whether the feature is supported by %Tizen::System::SystemInfo::GetValue() methods.
89 * @see AppWidgetProvider::OnAppWidgetProviderInitialize()
91 result Construct(const Tizen::Ui::Layout& layout, const Tizen::Graphics::FloatDimension& size);
95 // This method is for internal use only. Using this method can cause behavioral, security-related,
96 // and consistency-related issues in the application.
98 // Following method is reserved and may change its name at any time without prior notice.
100 virtual void AppWidgetFrame_Reserved1(void) {}
103 // This method is for internal use only. Using this method can cause behavioral, security-related,
104 // and consistency-related issues in the application.
106 // Following method is reserved and may change its name at any time without prior notice.
108 virtual void AppWidgetFrame_Reserved2(void) {}
111 // This method is for internal use only. Using this method can cause behavioral, security-related,
112 // and consistency-related issues in the application.
114 // Following method is reserved and may change its name at any time without prior notice.
116 virtual void AppWidgetFrame_Reserved3(void) {}
119 // This method is for internal use only. Using this method can cause behavioral, security-related,
120 // and consistency-related issues in the application.
122 // Following method is reserved and may change its name at any time without prior notice.
124 virtual void AppWidgetFrame_Reserved4(void) {}
127 // This method is for internal use only. Using this method can cause behavioral, security-related,
128 // and consistency-related issues in the application.
130 // Following method is reserved and may change its name at any time without prior notice.
132 virtual void AppWidgetFrame_Reserved5(void) {}
136 // The implementation of this copy constructor is intentionally blank and declared as private to prohibit copying of objects.
138 AppWidgetFrame(const AppWidgetFrame& rhs);
141 // The implementation of this copy assignment operator is intentionally blank and declared as private to prohibit copying of objects.
143 AppWidgetFrame& operator =(const AppWidgetFrame& rhs);
148 #endif // _FSHELL_APPWIDGET_FRAME_H_