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  //! The widget identifier
23  property string widgetId
24 
25  //! Variable used to contain widget's data
26  property var widgetData
27 
28  //! The ScopeStyle component.
29  property var scopeStyle: null
30 
31  //! Should the widget show in expanded mode (For those that support it)
32  property bool expanded: true
33 
34  //! Set margins width.
35  property real widgetMargins: units.gu(1)
36 
37  /// The parent (vertical) flickable this widget is in (if any)
38  property var parentFlickable: null
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 }