/usr/lib/x86_64-linux-gnu/qt5/qml/Ubuntu/Components/Popups/1.3/popupUtils.js is in qml-module-ubuntu-components-gles 1.3.1918+16.04.20160404-0ubuntu3.
This file is owned by root:root, with mode 0o644.
The actual contents of the file can be viewed below.
1 2 3 4 5 6 7 8 9 10 11 12 13 14 15 16 17 18 19 20 21 22 23 24 25 26 27 28 29 30 31 32 33 34 35 36 37 38 39 40 41 42 43 44 45 46 47 48 49 50 51 52 53 54 55 56 57 58 59 60 61 62 63 64 65 66 67 68 69 70 71 72 73 74 75 76 77 78 79 80 81 82 83 84 85 86 87 88 89 90 91 92 93 94 95 96 97 98 99 100 101 | /*
* Copyright 2012 Canonical Ltd.
*
* This program is free software; you can redistribute it and/or modify
* it under the terms of the GNU Lesser General Public License as published by
* the Free Software Foundation; version 3.
*
* This program is distributed in the hope that it will be useful,
* but WITHOUT ANY WARRANTY; without even the implied warranty of
* MERCHANTABILITY or FITNESS FOR A PARTICULAR PURPOSE. See the
* GNU Lesser General Public License for more details.
*
* You should have received a copy of the GNU Lesser General Public License
* along with this program. If not, see <http://www.gnu.org/licenses/>.
*/
/*!
\qmltype popupUtils
\inqmlmodule Ubuntu.Components.Popups 1.0
\ingroup ubuntu-popups
\brief Popover utility functions.
*/
/*!
\qmlmethod popupUtils::open(popup, caller, params)
The function creates and shows a popup object from either a \b Component or URL of a
QML document. The caller drives the placement of the popup as well as the
pointer's. The third parameter (param) can hold a series of properties configuring
the popup to be opened. This can be any property defined by the popups and additional
custom ones defined in derived popups.
\a caller should be given when a \l ComposerSheet or \l Dialog is specified using a URL
and opened inside a \b Window. If not, the application's root item will be the dismiss area.
Returns a popop object, which can be closed using \l close.
\qml
import Ubuntu.Components 1.3
import Ubuntu.Components.Popups 1.3
Button {
onClicked: PopupUtils.open(popoverComponent, popoverButton, { 'dummy': true } )
}
\endqml
See \l Popover, \l ComposerSheet and \l Dialog for their respective documentation and more examples.
*/
function open(popup, caller, params) {
var popupComponent = null;
var rootObject = null;
if (popup.createObject) {
// popup is a component and can create an object
popupComponent = popup;
rootObject = QuickUtils.rootItem(popup);
} else if (typeof popup === "string") {
popupComponent = Qt.createComponent(popup);
rootObject = (caller !== undefined) ? QuickUtils.rootItem(caller) : QuickUtils.rootItem(null);
} else {
print("PopupUtils.open(): "+popup+" is not a component or a link");
return null;
}
var popupObject;
if (params !== undefined) {
popupObject = popupComponent.createObject(rootObject, params);
} else {
popupObject = popupComponent.createObject(rootObject);
}
if (!popupObject) {
print(popupComponent.errorString().slice(0, -1));
print("PopupUtils.open(): Failed to create the popup object.");
return;
} else if (popupObject.hasOwnProperty("caller") && caller)
popupObject.caller = caller;
// if caller is specified, connect its cleanup to the popup's close
// so popups will be removed together with the caller.
if (caller)
caller.Component.onDestruction.connect(popupObject.__closePopup);
popupObject.show();
popupObject.onVisibleChanged.connect(popupObject.__closeIfHidden);
return popupObject;
}
/*!
\qmlmethod popupUtils::close(popupObject)
Closes (hides and destroys) the given popup.
\qml
import Ubuntu.Components 1.3
import Ubuntu.Components.Popups 1.3
Button {
onClicked: PopupUtils.close(popup)
}
\endqml
*/
function close(popupObject) {
popupObject.hide();
}
|