aboutsummaryrefslogtreecommitdiffstats
path: root/src/quickcontrols2/doc/src/qtquickcontrols2-fileselectors.qdoc
diff options
context:
space:
mode:
authorMitch Curtis <mitch.curtis@qt.io>2021-08-12 14:39:51 +0200
committerMitch Curtis <mitch.curtis@qt.io>2021-08-16 12:52:59 +0200
commit809339d1484cf556512534367b8170bc26baf072 (patch)
tree12871313b658f36d058b5ef25af1e247e9c46ce9 /src/quickcontrols2/doc/src/qtquickcontrols2-fileselectors.qdoc
parentb01b4f00eae8022c6a97d90f54dac395144ae095 (diff)
Remove qtquickcontrols2 sources and explain where they wentHEADdev
Now that qtquickcontrols2 has been merged into qtdeclarative, we should make it obvious that this repo should no longer be used, by preventing it from being built. Task-number: QTBUG-95173 Pick-to: 6.2 Change-Id: I95bd6a214f3d75a865ab163ee0a1f9ffbeb7a051 Reviewed-by: Alexandru Croitor <alexandru.croitor@qt.io> Reviewed-by: Volker Hilsheimer <volker.hilsheimer@qt.io>
Diffstat (limited to 'src/quickcontrols2/doc/src/qtquickcontrols2-fileselectors.qdoc')
-rw-r--r--src/quickcontrols2/doc/src/qtquickcontrols2-fileselectors.qdoc140
1 files changed, 0 insertions, 140 deletions
diff --git a/src/quickcontrols2/doc/src/qtquickcontrols2-fileselectors.qdoc b/src/quickcontrols2/doc/src/qtquickcontrols2-fileselectors.qdoc
deleted file mode 100644
index 4c782de1..00000000
--- a/src/quickcontrols2/doc/src/qtquickcontrols2-fileselectors.qdoc
+++ /dev/null
@@ -1,140 +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-fileselectors.html
- \title Using File Selectors with Qt Quick Controls
-
- \l {QFileSelector}{File selectors} provide a convenient way of selecting
- file variants. Qt offers the platform name and the locale as built-in
- selectors. Qt Quick Controls extends the built-in selectors with the name
- (lowercase) of the style that an application is running with.
-
- By using file selectors, style-specific tweaks can be applied without
- creating a hard dependency to a style. From the available file variants,
- only the selected QML file is loaded by the QML engine. Each file variant
- can assume the context, that is, a specific style. This typically leads
- to some code duplication, but on the other hand, cuts the aforementioned
- hard dependency to the style, and leads to simpler and more efficient
- QML code.
-
- The following example demonstrates a custom rounded button that has a
- styled drop shadow in the \l {Material Style}{Material style}, and looks
- flat in other styles. The files are organized so that the Material version
- of \c CustomButton.qml is placed into a \c +Material sub-directory.
-
- \code
- :/main.qml
- :/CustomButton.qml
- :/+Material/CustomButton.qml
- \endcode
-
- By default, \c main.qml will use \c CustomButton.qml for the \c CustomButton
- type. However, when the application is run with the Material style, the
- \c Material selector will be present and the \c +Material/CustomButton.qml
- version will be used instead.
-
- \code
- // main.qml
- import QtQuick
- import QtQuick.Controls
-
- ApplicationWindow {
- id: window
- visible: true
-
- CustomButton {
- text: "Button"
- anchors.centerIn: parent
- }
- }
- \endcode
-
- The base implementation of the custom button is a simple rounded
- flat button.
-
- \code
- // CustomButton.qml
- import QtQuick
- import QtQuick.Controls
-
- Button {
- id: control
-
- background: Rectangle {
- radius: width / 2
- implicitWidth: 36
- implicitHeight: 36
- color: control.pressed ? "#ccc" : "#eee"
- }
- }
- \endcode
-
- The Material style's implementation of the custom button imports the
- Material style, requests a dark theme to get light text, and creates
- a drop shadow for the background.
-
- \code
- // +Material/CustomButton.qml
- import QtQuick
- import QtGraphicalEffects
- import QtQuick.Controls
- import QtQuick.Controls.Material
-
- Button {
- id: control
-
- Material.theme: Material.Dark
-
- background: Rectangle {
- implicitWidth: 48
- implicitHeight: 48
- color: Material.accentColor
- radius: width / 2
-
- layer.enabled: control.enabled
- layer.effect: DropShadow {
- verticalOffset: 1
- color: Material.dropShadowColor
- samples: control.pressed ? 20 : 10
- spread: 0.5
- }
- }
- }
- \endcode
-
- \note It is recommended to use \l QQmlApplicationEngine, which internally
- creates a \l QQmlFileSelector instance. This is all that is needed to take
- QML file selectors into use.
-
- \section1 Related Information
- \list
- \li \l {QFileSelector}
- \li \l {QQmlFileSelector}
- \li \l {Styling Qt Quick Controls}
- \endlist
-*/