Qt 5.9 | Qt Quick Extras | Qt Quick Extras - Gallery | ControlView.qml Example File

Qt 5.9.2 Reference Documentation

# ControlView.qml Example File

gallery/qml/ControlView.qml

      /****************************************************************************
      **
      ** Copyright (C) 2016 The Qt Company Ltd.
      ** Contact: https://www.qt.io/licensing/
      **
      ** This file is part of the examples of the Qt Toolkit.
      **
      ** $QT_BEGIN_LICENSE:BSD$
      ** 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.
      **
      ** BSD License Usage
      ** Alternatively, you may use this file under the terms of the BSD license
      ** as follows:
      **
      ** "Redistribution and use in source and binary forms, with or without
      ** modification, are permitted provided that the following conditions are
      ** met:
      **   * Redistributions of source code must retain the above copyright
      **     notice, this list of conditions and the following disclaimer.
      **   * Redistributions in binary form must reproduce the above copyright
      **     notice, this list of conditions and the following disclaimer in
      **     the documentation and/or other materials provided with the
      **     distribution.
      **   * Neither the name of The Qt Company Ltd nor the names of its
      **     contributors may be used to endorse or promote products derived
      **     from this software without specific prior written permission.
      **
      **
      ** THIS SOFTWARE IS PROVIDED BY THE COPYRIGHT HOLDERS AND CONTRIBUTORS
      ** "AS IS" AND ANY EXPRESS OR IMPLIED WARRANTIES, INCLUDING, BUT NOT
      ** LIMITED TO, THE IMPLIED WARRANTIES OF MERCHANTABILITY AND FITNESS FOR
      ** A PARTICULAR PURPOSE ARE DISCLAIMED. IN NO EVENT SHALL THE COPYRIGHT
      ** OWNER OR CONTRIBUTORS BE LIABLE FOR ANY DIRECT, INDIRECT, INCIDENTAL,
      ** SPECIAL, EXEMPLARY, OR CONSEQUENTIAL DAMAGES (INCLUDING, BUT NOT
      ** LIMITED TO, PROCUREMENT OF SUBSTITUTE GOODS OR SERVICES; LOSS OF USE,
      ** DATA, OR PROFITS; OR BUSINESS INTERRUPTION) HOWEVER CAUSED AND ON ANY
      ** THEORY OF LIABILITY, WHETHER IN CONTRACT, STRICT LIABILITY, OR TORT
      ** (INCLUDING NEGLIGENCE OR OTHERWISE) ARISING IN ANY WAY OUT OF THE USE
      ** OF THIS SOFTWARE, EVEN IF ADVISED OF THE POSSIBILITY OF SUCH DAMAGE."
      **
      ** $QT_END_LICENSE$
      **
      ****************************************************************************/

      import QtQuick 2.2
      import QtQuick.Controls 1.1

      Rectangle {
          id: view
          color: darkBackground ? "transparent" : lightBackgroundColor

          Keys.onReleased: {
              if (event.key === Qt.Key_Back) {
                  stackView.pop();
                  event.accepted = true;
              }
          }

          property bool darkBackground: true

          property Component control
          property Component customizer

          property alias controlItem: controlLoader.item
          property alias customizerItem: customizerLoader.item

          property bool isCustomizerVisible: false

          property real margin: root.toPixels(0.05)

          property rect controlBounds: Qt.rect(largestControlItem.x + controlBoundsItem.x,
              largestControlItem.y + controlBoundsItem.y, controlBoundsItem.width, controlBoundsItem.height)

          Item {
              id: largestControlItem
              x: margin
              y: margin
              width: isCustomizerVisible ? widthWhenCustomizing : widthWhenNotCustomizing
              height: isCustomizerVisible ? heightWhenCustomizing : heightWhenNotCustomizing

              readonly property real widthWhenCustomizing: (!isScreenPortrait ? parent.width / 2 : parent.width) - margin * 2
              readonly property real heightWhenCustomizing: (isScreenPortrait ? parent.height / 2 : parent.height - toolbar.height) - margin * 2
              readonly property real widthWhenNotCustomizing: parent.width - margin * 2
              readonly property real heightWhenNotCustomizing: parent.height - toolbar.height - margin * 2

              Item {
                  id: controlBoundsItem
                  x: parent.width / 2 - controlBoundsItem.width / 2
                  y: customizer && customizerItem.visible ? 0 : (isScreenPortrait ? (parent.height / 2) - (controlBoundsItem.height / 2) : 0)
                  width: Math.min(parent.widthWhenCustomizing, parent.widthWhenNotCustomizing)
                  height: Math.min(parent.heightWhenCustomizing, parent.heightWhenNotCustomizing)

                  Behavior on x {
                      id: controlXBehavior
                      enabled: false
                      NumberAnimation {}
                  }

                  Behavior on y {
                      id: controlYBehavior
                      enabled: false
                      NumberAnimation {}
                  }

                  Loader {
                      id: controlLoader
                      sourceComponent: control
                      anchors.centerIn: parent

                      property alias view: view
                  }
              }
          }

          Flickable {
              id: flickable
              // Hide the customizer on the right of the screen if it's not visible.
              x: (isScreenPortrait ? 0 : (isCustomizerVisible ? largestControlItem.x + largestControlItem.width + margin : view.width)) + margin
              y: (isScreenPortrait ? largestControlItem.y + largestControlItem.height : 0) + margin
              width: largestControlItem.width
              height: parent.height - y - toolbar.height - margin
              anchors.leftMargin: margin
              anchors.rightMargin: margin
              visible: customizerLoader.opacity > 0

              flickableDirection: Flickable.VerticalFlick

              clip: true
              contentWidth: width
              contentHeight: customizerLoader.height

              Behavior on x {
                  id: flickableXBehavior
                  enabled: false
                  NumberAnimation {}
              }

              Behavior on y {
                  id: flickableYBehavior
                  enabled: false
                  NumberAnimation {}
              }

              Loader {
                  id: customizerLoader
                  sourceComponent: customizer
                  opacity: 0
                  width: flickable.width

                  property alias view: view

                  Behavior on opacity {
                      NumberAnimation {
                          duration: 300
                      }
                  }
              }
          }

          ControlViewToolbar {
              id: toolbar

              onCustomizeClicked: {
                  controlXBehavior.enabled = !isScreenPortrait;
                  controlYBehavior.enabled = isScreenPortrait;

                  isCustomizerVisible = !isCustomizerVisible;

                  if (isScreenPortrait) {
                      flickableXBehavior.enabled = false;
                      flickableYBehavior.enabled = true;
                  } else {
                      flickableXBehavior.enabled = true;
                      flickableYBehavior.enabled = false;
                  }

                  customizerLoader.opacity = isCustomizerVisible ? 1 : 0;
              }
          }

          FlickableMoreIndicator {
              flickable: flickable
              atTop: true
              gradientColor: view.darkBackground ? darkBackgroundColor : lightBackgroundColor
          }

          FlickableMoreIndicator {
              flickable: flickable
              atTop: false
              gradientColor: view.darkBackground ? darkBackgroundColor : lightBackgroundColor
          }
      }