diff options
Diffstat (limited to 'src/quickcontrols2/doc/src/qtquickcontrols2-input.qdoc')
-rw-r--r-- | src/quickcontrols2/doc/src/qtquickcontrols2-input.qdoc | 123 |
1 files changed, 0 insertions, 123 deletions
diff --git a/src/quickcontrols2/doc/src/qtquickcontrols2-input.qdoc b/src/quickcontrols2/doc/src/qtquickcontrols2-input.qdoc deleted file mode 100644 index 6bc037e0..00000000 --- a/src/quickcontrols2/doc/src/qtquickcontrols2-input.qdoc +++ /dev/null @@ -1,123 +0,0 @@ -/**************************************************************************** -** -** Copyright (C) 2017 The Qt Company Ltd. -** Contact: https://www.qt.io/licensing/ -** -** This file is part of the documentation of the Qt Toolkit. -** -** $QT_BEGIN_LICENSE:FDL$ -** Commercial License Usage -** Licensees holding valid commercial Qt licenses may use this file in -** accordance with the commercial license agreement provided with the -** Software or, alternatively, in accordance with the terms contained in -** a written agreement between you and The Qt Company. For licensing terms -** and conditions see https://www.qt.io/terms-conditions. For further -** information use the contact form at https://www.qt.io/contact-us. -** -** GNU Free Documentation License Usage -** Alternatively, this file may be used under the terms of the GNU Free -** Documentation License version 1.3 as published by the Free Software -** Foundation and appearing in the file included in the packaging of -** this file. Please review the following information to ensure -** the GNU Free Documentation License version 1.3 requirements -** will be met: https://www.gnu.org/licenses/fdl-1.3.html. -** $QT_END_LICENSE$ -** -****************************************************************************/ - -/*! - \page qtquickcontrols2-input.html - \title Input Controls - \ingroup qtquickcontrols2-guidelines - \brief Guidelines for input controls - - Qt Quick Controls offers a variety of input controls for both numeric - and textual input. - - \annotatedlist qtquickcontrols2-input - - 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. - - \section1 ComboBox Control - - \image qtquickcontrols2-combobox.gif - - \l ComboBox 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. - - Recommendations: - \list - \li If the number of values is very large, consider applying a filter. - \li If the list is very limited, consider using RadioButton. This has the - advantage that the user can see all options at the same time. - \li Select a default value, the value that will be chosen most often. - \endlist - - \b {See also} \l {CheckBox Control}, \l {Tumbler Control}. - - \section1 Dial Control - - \image qtquickcontrols2-dial.png - - \l Dial is similar to a traditional dial knob that is found on devices such - as stereos or industrial equipment. - - The dial is rotated by clicking and dragging, with the handle indicating the - value of the dial. - - For applications where fast input is important, the circular - \l {Dial::inputMode}{input mode} is useful, as clicking on the dial will - move it directly to that position. - - For applications where precise input is important, the horizontal and - vertical input modes are recommended, as these allow small adjustments to - be made relative to where the dial is clicked. These modes are also better - for dials where large jumps in values could be unsafe, such as a dial that - controls audio volume. - - \b {See also} \l {Tumbler Control}. - - \section1 TextArea Control - - \image qtquickcontrols2-textarea.png - - \l TextArea is a multi-line text editor. - - \section1 TextField Control - - \image qtquickcontrols2-textfield.png - - \l TextField is a single line text editor. - - \b {See also} \l {Tumbler Control}. - - \section1 Slider Control - - \image qtquickcontrols2-slider.gif - - \l Slider is used to select a value by sliding a handle along a track. - - \section1 RangeSlider Control - - \image qtquickcontrols2-rangeslider.gif - - \l RangeSlider is used to select a range specified by two values, - by sliding each handle along a track. - - \b {See also} \l {Slider Control}. - - \section1 Tumbler Control - - \image qtquickcontrols2-tumbler.png - - \l Tumbler is a spinnable wheel of items that can be selected. - - \b {See also} \l {ComboBox Control}. - - \section1 Related Information - \list - \li \l {Qt Quick Controls Guidelines} - \endlist -*/ |