/usr/share/qt5/doc/qtquickcontrols2/qtquickcontrols2-popups.html is in qtquickcontrols2-5-doc-html 5.9.5-0ubuntu2.
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 | <?xml version="1.0" encoding="UTF-8"?>
<!DOCTYPE html>
<html lang="en">
<head>
<meta http-equiv="Content-Type" content="text/html; charset=utf-8" />
<!-- qtquickcontrols2-popups.qdoc -->
<title>Popup Controls | Qt Quick Controls 2 5.9</title>
<link rel="stylesheet" type="text/css" href="style/offline-simple.css" />
<script type="text/javascript">
document.getElementsByTagName("link").item(0).setAttribute("href", "style/offline.css");
// loading style sheet breaks anchors that were jumped to before
// so force jumping to anchor again
setTimeout(function() {
var anchor = location.hash;
// need to jump to different anchor first (e.g. none)
location.hash = "#";
setTimeout(function() {
location.hash = anchor;
}, 0);
}, 0);
</script>
</head>
<body>
<div class="header" id="qtdocheader">
<div class="main">
<div class="main-rounded">
<div class="navigationbar">
<table><tr>
<td >Qt 5.9</td><td ><a href="qtquickcontrols2-index.html">Qt Quick Controls 2</a></td><td >Popup Controls</td></tr></table><table class="buildversion"><tr>
<td id="buildversion" width="100%" align="right">Qt 5.9.5 Reference Documentation</td>
</tr></table>
</div>
</div>
<div class="content">
<div class="line">
<div class="content mainContent">
<div class="sidebar">
<div class="toc">
<h3><a name="toc">Contents</a></h3>
<ul>
<li class="level1"><a href="#drawer-control">Drawer Control</a></li>
<li class="level1"><a href="#menu-control">Menu Control</a></li>
<li class="level1"><a href="#popup-control">Popup Control</a></li>
<li class="level1"><a href="#tooltip-control">ToolTip Control</a></li>
<li class="level1"><a href="#related-information">Related Information</a></li>
</ul>
</div>
<div class="sidebar-content" id="sidebar-content"></div></div>
<h1 class="title">Popup Controls</h1>
<span class="subtitle"></span>
<!-- $$$qtquickcontrols2-popups.html-description -->
<div class="descr"> <a name="details"></a>
<div class="table"><table class="annotated">
<tr class="odd topAlign"><td class="tblName"><p><a href="qml-qtquick-controls2-dialog.html">Dialog</a></p></td><td class="tblDescr"><p>Popup dialog with standard buttons and a title, used for short-term interaction with the user</p></td></tr>
<tr class="even topAlign"><td class="tblName"><p><a href="qml-qtquick-controls2-drawer.html">Drawer</a></p></td><td class="tblDescr"><p>Side panel that can be opened and closed using a swipe gesture</p></td></tr>
<tr class="odd topAlign"><td class="tblName"><p><a href="qml-qtquick-controls2-menu.html">Menu</a></p></td><td class="tblDescr"><p>Popup that can be used as a context menu or popup menu</p></td></tr>
<tr class="even topAlign"><td class="tblName"><p><a href="qml-qtquick-controls2-popup.html">Popup</a></p></td><td class="tblDescr"><p>Base type of popup-like user interface controls</p></td></tr>
<tr class="odd topAlign"><td class="tblName"><p><a href="qml-qtquick-controls2-tooltip.html">ToolTip</a></p></td><td class="tblDescr"><p>Provides tool tips for any control</p></td></tr>
</table></div>
<p>Each type of popup control has its own specific target use case. The following sections offer guidelines for choosing the appropriate type of popup control, depending on the use case.</p>
<a name="drawer-control"></a>
<h2 id="drawer-control">Drawer Control</h2>
<p class="centerAlign"><img src="images/qtquickcontrols2-drawer-expanded-wireframe.png" alt="" /></p><p><a href="qml-qtquick-controls2-drawer.html">Drawer</a> provides a swipe-based side panel, similar to those often used in touch interfaces to provide a central location for navigation.</p>
<p>The drawer can be positioned at any of the four edges of the screen. It allows the user to add navigation without taking up valuable screen space. The user can show and hide the drawer at any time with a simple swipe movement.</p>
<a name="menu-control"></a>
<h2 id="menu-control">Menu Control</h2>
<p class="centerAlign"><img src="images/qtquickcontrols2-menu.png" alt="" /></p><p>The <a href="qml-qtquick-controls2-menu.html">Menu</a> control displays a vertical list of items that can be selected. It can be used for offering a list of actions that can be taken in a given context.</p>
<p><b>See also</b> <a href="qtquickcontrols2-popups.html#drawer-control">Drawer Control</a>.</p>
<a name="popup-control"></a>
<h2 id="popup-control">Popup Control</h2>
<p class="centerAlign"><img src="images/qtquickcontrols2-popup-settings.png" alt="" /></p><p>A <a href="qml-qtquick-controls2-popup.html">Popup</a> displays content over other application content. It prompts the user to make a decision or enter information.</p>
<p>Popups can be modal or non-modal. A modal popup blocks users from interacting with the application until they have made a choice and closed the popup.</p>
<p>A popup can be used for:</p>
<ul>
<li>communicating a message to the user that they must read and acknowledge.</li>
<li>displaying an error message.</li>
<li>prompting the user to make a choice and/or enter a value.</li>
</ul>
<a name="tooltip-control"></a>
<h2 id="tooltip-control">ToolTip Control</h2>
<p class="centerAlign"><img src="images/qtquickcontrols2-tooltip.png" alt="" /></p><p><a href="qml-qtquick-controls2-tooltip.html">ToolTip</a> shows a short piece of text that informs the user of a control's function. It is typically placed above or below the parent control.</p>
<p>Recommendations:</p>
<ul>
<li>Use a tooltip if a control has little or no descriptive text, or needs a short explanation.</li>
<li>Use a tooltip only if the information on a particular control is not available elsewhere in the screen.</li>
<li>Keep the tooltip text short so that it does not cover other content while being displayed.</li>
</ul>
<a name="related-information"></a>
<h2 id="related-information">Related Information</h2>
<ul>
<li><a href="qtquickcontrols2-guidelines.html">Qt Quick Controls 2 Guidelines</a></li>
</ul>
</div>
<!-- @@@qtquickcontrols2-popups.html -->
</div>
</div>
</div>
</div>
</div>
<div class="footer">
<p>
<acronym title="Copyright">©</acronym> 2017 The Qt Company Ltd.
Documentation contributions included herein are the copyrights of
their respective owners.<br> The documentation provided herein is licensed under the terms of the <a href="http://www.gnu.org/licenses/fdl.html">GNU Free Documentation License version 1.3</a> as published by the Free Software Foundation.<br> Qt and respective logos are trademarks of The Qt Company Ltd. in Finland and/or other countries worldwide. All other trademarks are property
of their respective owners. </p>
</div>
</body>
</html>
|