Unity 8
PreviewWidget.qml
1 /*
2  * Copyright (C) 2014 Canonical, Ltd.
3  *
4  * This program is free software; you can redistribute it and/or modify
5  * it under the terms of the GNU General Public License as published by
6  * the Free Software Foundation; version 3.
7  *
8  * This program is distributed in the hope that it will be useful,
9  * but WITHOUT ANY WARRANTY; without even the implied warranty of
10  * MERCHANTABILITY or FITNESS FOR A PARTICULAR PURPOSE. See the
11  * GNU General Public License for more details.
12  *
13  * You should have received a copy of the GNU General Public License
14  * along with this program. If not, see <http://www.gnu.org/licenses/>.
15  */
16 
17 import QtQuick 2.4
18 
19 /*! Interface for preview widgets. */
20 
21 Item {
22  //! Specifies the preview widget being currently used or not
23  property bool isCurrentPreview: true
24 
25  //! The widget identifier
26  property string widgetId
27 
28  //! Variable used to contain widget's data
29  property var widgetData
30 
31  //! The ScopeStyle component.
32  property var scopeStyle: null
33 
34  //! Should the widget show in expanded mode (For those that support it)
35  property bool expanded: true
36 
37  //! Set margins width.
38  property real widgetMargins: units.gu(1)
39 
40  /*! \brief This signal should be emitted when a preview action was triggered.
41  *
42  * \param widgetId, actionId Respective identifiers from widgetData.
43  * \param data Optional widget-specific data sent to the scope.
44  */
45  signal triggered(string widgetId, string actionId, var data)
46 
47  /*! \brief This signal should be emitted when widget gains the focus
48  * and input method popups.
49  * And preview widget should reposition in visible area to avoid
50  * keyboard appears over the widget.
51  *
52  * \param item, id of specified item which is needed to reposition.
53  */
54  signal makeSureVisible(var item)
55 
56  objectName: widgetId
57 }