2 * Copyright (C) 2014 Canonical, Ltd.
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.
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.
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/>.
19 /*! Interface for preview widgets. */
22 //! The widget identifier
23 property string widgetId
25 //! Variable used to contain widget's data
26 property var widgetData
28 //! The ScopeStyle component.
29 property var scopeStyle: null
31 //! Should the widget show in expanded mode (For those that support it)
32 property bool expanded: true
34 //! Set margins width.
35 property real widgetMargins: units.gu(1)
37 /// The parent (vertical) flickable this widget is in (if any)
38 property var parentFlickable: null
40 /*! \brief This signal should be emitted when a preview action was triggered.
42 * \param widgetId, actionId Respective identifiers from widgetData.
43 * \param data Optional widget-specific data sent to the scope.
45 signal triggered(string widgetId, string actionId, var data)
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.
52 * \param item, id of specified item which is needed to reposition.
54 signal makeSureVisible(var item)