/usr/share/qt5/doc/qtquickcontrols2/qtquickcontrols2-input.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 109 110 111 112 113 114 115 116 117 118 119 120 | <?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-input.qdoc -->
<title>Input 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 >Input 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="#combobox-control">ComboBox Control</a></li>
<li class="level1"><a href="#dial-control">Dial Control</a></li>
<li class="level1"><a href="#textarea-control">TextArea Control</a></li>
<li class="level1"><a href="#textfield-control">TextField Control</a></li>
<li class="level1"><a href="#slider-control">Slider Control</a></li>
<li class="level1"><a href="#rangeslider-control">RangeSlider Control</a></li>
<li class="level1"><a href="#tumbler-control">Tumbler 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">Input Controls</h1>
<span class="subtitle"></span>
<!-- $$$qtquickcontrols2-input.html-description -->
<div class="descr"> <a name="details"></a>
<p>Qt Quick Controls 2 offers a variety of input controls for both numeric and textual input.</p>
<div class="table"><table class="annotated">
<tr class="odd topAlign"><td class="tblName"><p><a href="qml-qtquick-controls2-combobox.html">ComboBox</a></p></td><td class="tblDescr"><p>Combined button and popup list for selecting options</p></td></tr>
<tr class="even topAlign"><td class="tblName"><p><a href="qml-qtquick-controls2-dial.html">Dial</a></p></td><td class="tblDescr"><p>Circular dial that is rotated to set a value</p></td></tr>
<tr class="odd topAlign"><td class="tblName"><p><a href="qml-qtquick-controls2-rangeslider.html">RangeSlider</a></p></td><td class="tblDescr"><p>Used to select a range of values by sliding two handles along a track</p></td></tr>
<tr class="even topAlign"><td class="tblName"><p><a href="qml-qtquick-controls2-slider.html">Slider</a></p></td><td class="tblDescr"><p>Used to select a value by sliding a handle along a track</p></td></tr>
<tr class="odd topAlign"><td class="tblName"><p><a href="qml-qtquick-controls2-textarea.html">TextArea</a></p></td><td class="tblDescr"><p>Multi-line text input area</p></td></tr>
<tr class="even topAlign"><td class="tblName"><p><a href="qml-qtquick-controls2-textfield.html">TextField</a></p></td><td class="tblDescr"><p>Single-line text input field</p></td></tr>
<tr class="odd topAlign"><td class="tblName"><p><a href="qml-qtquick-controls2-tumbler.html">Tumbler</a></p></td><td class="tblDescr"><p>Spinnable wheel of items that can be selected</p></td></tr>
</table></div>
<p>Each type of input control has its own specific target use case. The following sections offer guidelines for choosing the appropriate type of input control, depending on the use case.</p>
<a name="combobox-control"></a>
<h2 id="combobox-control">ComboBox Control</h2>
<p class="centerAlign"><img src="images/qtquickcontrols2-combobox.gif" alt="" /></p><p><a href="qml-qtquick-controls2-combobox.html">ComboBox</a> is used to select a value from a static multiple-line drop-down list. It is not possible to add new values, and only one option can be selected.</p>
<p>Recommendations:</p>
<ul>
<li>If the number of values is very large, consider applying a filter.</li>
<li>If the list is very limited, consider using <a href="qml-qtquick-controls2-radiobutton.html">RadioButton</a>. This has the advantage that the user can see all options at the same time.</li>
<li>Select a default value, the value that will be chosen most often.</li>
</ul>
<p><b>See also</b> <a href="qtquickcontrols2-buttons.html#checkbox-control">CheckBox Control</a>, <a href="qtquickcontrols2-input.html#tumbler-control">Tumbler Control</a>.</p>
<a name="dial-control"></a>
<h2 id="dial-control">Dial Control</h2>
<p class="centerAlign"><img src="images/qtquickcontrols2-dial.png" alt="" /></p><p><a href="qml-qtquick-controls2-dial.html">Dial</a> is similar to a traditional dial knob that is found on devices such as stereos or industrial equipment.</p>
<p>The dial is rotated by clicking and dragging, with the handle indicating the value of the dial.</p>
<p><b>See also</b> <a href="qtquickcontrols2-input.html#tumbler-control">Tumbler Control</a>.</p>
<a name="textarea-control"></a>
<h2 id="textarea-control">TextArea Control</h2>
<p class="centerAlign"><img src="images/qtquickcontrols2-textarea.png" alt="" /></p><p><a href="qml-qtquick-controls2-textarea.html">TextArea</a> is a multi-line text editor.</p>
<a name="textfield-control"></a>
<h2 id="textfield-control">TextField Control</h2>
<p class="centerAlign"><img src="images/qtquickcontrols2-textfield.png" alt="" /></p><p><a href="qml-qtquick-controls2-textfield.html">TextField</a> is a single line text editor.</p>
<p><b>See also</b> <a href="qtquickcontrols2-input.html#tumbler-control">Tumbler Control</a>.</p>
<a name="slider-control"></a>
<h2 id="slider-control">Slider Control</h2>
<p class="centerAlign"><img src="images/qtquickcontrols2-slider.gif" alt="" /></p><p><a href="qml-qtquick-controls2-slider.html">Slider</a> is used to select a value by sliding a handle along a track.</p>
<a name="rangeslider-control"></a>
<h2 id="rangeslider-control">RangeSlider Control</h2>
<p class="centerAlign"><img src="images/qtquickcontrols2-rangeslider.gif" alt="" /></p><p><a href="qml-qtquick-controls2-rangeslider.html">RangeSlider</a> is used to select a range specified by two values, by sliding each handle along a track.</p>
<p><b>See also</b> <a href="qtquickcontrols2-input.html#slider-control">Slider Control</a>.</p>
<a name="tumbler-control"></a>
<h2 id="tumbler-control">Tumbler Control</h2>
<p class="centerAlign"><img src="images/qtquickcontrols2-tumbler.png" alt="" /></p><p><a href="qml-qtquick-controls2-tumbler.html">Tumbler</a> is a spinnable wheel of items that can be selected.</p>
<p><b>See also</b> <a href="qtquickcontrols2-input.html#combobox-control">ComboBox Control</a>.</p>
<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-input.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>
|