/usr/lib/x86_64-linux-gnu/qt5/qml/Ubuntu/Components/Popups/1.2/Popover.qml is in qml-module-ubuntu-components 1.3.1918+16.04.20160404-0ubuntu1.
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 102 103 104 105 106 107 108 109 110 111 112 113 114 115 116 117 118 119 120 121 122 123 124 125 126 127 128 129 130 131 132 133 134 135 136 137 138 139 140 141 142 143 144 145 146 147 148 149 150 151 152 153 154 155 156 157 158 159 160 161 162 163 164 165 166 167 168 169 170 171 172 173 174 175 176 177 178 179 180 181 182 183 184 185 186 187 188 189 190 191 192 193 194 195 196 197 198 199 200 201 202 203 204 205 206 207 208 209 210 211 212 213 214 215 216 217 218 219 220 221 222 223 224 225 226 227 228 229 230 231 232 233 234 235 236 237 238 239 240 241 242 243 244 245 246 247 248 249 250 251 252 253 254 255 256 257 258 259 260 261 262 263 264 265 266 267 268 269 270 271 272 273 274 275 276 277 278 279 280 281 282 283 284 285 286 287 288 289 290 291 292 293 294 295 296 297 298 299 300 301 302 303 304 | /*
* 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/>.
*/
import QtQuick 2.4
import "internalPopupUtils.js" as InternalPopupUtils
import Ubuntu.Components 1.2
/*!
\qmltype Popover
\inherits PopupBase
\inqmlmodule Ubuntu.Components.Popups 1.0
\ingroup ubuntu-popups
\brief A popover allows an application to present additional content without changing the view.
A popover has a fixed width and automatic height, depending on is contents.
It can be closed by clicking anywhere outside of the popover area.
\l {https://design.ubuntu.com/apps/building-blocks/dialog#popover}{See also the Design Guidelines on Popovers}.
Example:
\qml
import QtQuick 2.4
import Ubuntu.Components 1.2
import Ubuntu.Components.ListItems 1.0 as ListItem
import Ubuntu.Components.Popups 1.0
Rectangle {
color: Theme.palette.normal.background
width: units.gu(80)
height: units.gu(80)
Component {
id: popoverComponent
Popover {
id: popover
Column {
id: containerLayout
anchors {
left: parent.left
top: parent.top
right: parent.right
}
ListItem.Header { text: "Standard list items" }
ListItem.Standard { text: "Do something" }
ListItem.Standard { text: "Do something else" }
ListItem.Header { text: "Buttons" }
ListItem.SingleControl {
highlightWhenPressed: false
control: Button {
text: "Do nothing"
anchors {
fill: parent
margins: units.gu(1)
}
}
}
ListItem.SingleControl {
highlightWhenPressed: false
control: Button {
text: "Close"
anchors {
fill: parent
margins: units.gu(1)
}
onClicked: PopupUtils.close(popover)
}
}
}
}
}
Button {
id: popoverButton
anchors.centerIn: parent
text: "open"
onClicked: PopupUtils.open(popoverComponent, popoverButton)
}
}
\endqml
*/
PopupBase {
id: popover
/*!
\qmlproperty list<Object> container
Content will be put inside the foreround of the Popover.
*/
default property alias container: containerItem.data
/*!
\qmlproperty real contentWidth
Use this property to override the default content width.
*/
property alias contentWidth: foreground.width
/*!
\qmlproperty real contentHeight
Use this property to override the default content height.
*/
property alias contentHeight: foreground.height
/*!
The Item such as a \l Button that the user interacted with to open the Dialog.
This property will be used for the automatic positioning of the Dialog next to
the caller, if possible.
*/
property Item caller
/*!
The property holds the item to which the pointer should be anchored to.
This can be same as the caller or any child of the caller. By default the
property is set to caller.
*/
property Item pointerTarget: caller
/*!
The property holds the margins from the popover's dismissArea. The property
is themed.
*/
property real edgeMargins: foreground.square ? 0 : units.gu(2)
/*!
The property holds the margin from the popover's caller. The property
is themed.
*/
property real callerMargin: 0
/*!
The property drives the automatic closing of the Popover when user taps
on the dismissArea. The default behavior is to close the Popover, therefore
set to true.
When set to false, closing the Popover is the responsibility of the caller.
Also, the mouse and touch events are not blocked from the dismissArea.
*/
property bool autoClose: true
/*!
\qmlproperty Component foregroundStyle
Exposes the style property of the \l StyledItem contained in the Popover.
Refer to \l StyledItem how to use it.
*/
property alias foregroundStyle: foreground.style
/*!
Make the popover visible. Reparent to the background area object first if needed.
Only use this function if you handle memory management. Otherwise use
PopupUtils.open() to do it automatically.
*/
function show() {
/* Cannot call parent's show() however PopupBase::show()
does not do anything useful to us.
https://bugreports.qt-project.org/browse/QTBUG-25942
http://qt-project.org/forums/viewthread/19577
*/
visible = true;
foreground.show();
}
/*!
Hide the popover.
Only use this function if you handle memory management. Otherwise use
PopupUtils.close() to do it automatically.
*/
function hide() {
foreground.hide();
}
Component.onCompleted: foreground.hideCompleted.connect(popover.__makeInvisible)
/*!
\internal
*/
function __makeInvisible() {
visible = false;
}
QtObject {
id: internal
property bool portrait: width < height
// private
function updatePosition() {
if (pointerTarget && pointerTarget.parent)
popover.y = (popover.parent.height - popover.height) / 2;
var pos = new InternalPopupUtils.CallerPositioning(foreground, pointer, dismissArea, caller, pointerTarget, edgeMargins, callerMargin);
pos.auto();
}
}
__foreground: foreground
__eventGrabber.enabled: autoClose
__closeOnDismissAreaPress: true
y: parent ? (parent.height - height) / 2 : 0
StyledItem {
id: foreground
activeFocusOnPress: true
objectName: "popover_foreground"
//styling properties
property real minimumWidth: units.gu(40)
property real maxWidth: dismissArea ? (internal.portrait ? dismissArea.width : dismissArea.width * 3/4) : 0.0
property real maxHeight: dismissArea ? (internal.portrait ? dismissArea.height * 3/4 : dismissArea.height) : 0.0
width: Math.min(minimumWidth, maxWidth)
height: containerItem.height
Item {
id: containerItem
parent: foreground.__styleInstance.contentItem
anchors {
left: parent.left
top: parent.top
right: parent.right
}
height: childrenRect.height
}
onWidthChanged: internal.updatePosition()
onHeightChanged: internal.updatePosition()
property point target: Qt.point(pointer.x - x, pointer.y - y)
property string direction: pointer.direction
property bool clipContent: true
property bool square: popover.hasOwnProperty("square") ? popover.square : false
signal show()
signal hide()
signal showCompleted()
signal hideCompleted()
style: Theme.createStyleComponent("PopoverForegroundStyle.qml", foreground)
}
QtObject {
id: pointer
/* Input variables for InternalPopupUtils are the properties:
- horizontalMargin
- verticalMargin
- size
Output variables of InternalPopupUtils are the properties:
- x
- y
- direction
*/
property real arrowSize: units.dp(15)
property real cornerSize: units.dp(11)
/* Minimum distance between the top or bottom of the popup and
the tip of the pointer when the direction is left or right.
*/
property real horizontalMargin: arrowSize/2.0 + cornerSize
/* Minimum distance between the left or right of the popup and
the tip of the pointer when the direction is up or down.
*/
property real verticalMargin: arrowSize/2.0 + cornerSize
/* Either:
- distance between the left or right of the popup and the tip
of the pointer when the direction is left or right.
- distance between the top or bottom of the popup and the tip
of the pointer when the direction is up or down.
*/
property real size: units.dp(6)
property real x
property real y
property string direction
}
/*! \internal */
onCallerChanged: internal.updatePosition()
/*! \internal */
onPointerTargetChanged: internal.updatePosition()
/*! \internal */
onWidthChanged: internal.updatePosition()
/*! \internal */
onHeightChanged: internal.updatePosition()
/*! \internal */
onRotatingChanged: hide()
Connections {
target: pointerTarget
onXChanged: internal.updatePosition()
onYChanged: internal.updatePosition()
onWidthChanged: internal.updatePosition()
onHeightChanged: internal.updatePosition()
}
}
|