BusyIndicator.qml 3.0 KB

1234567891011121314151617181920212223242526272829303132333435363738394041424344454647484950515253545556575859606162636465666768697071727374757677787980818283848586
  1. /****************************************************************************
  2. **
  3. ** Copyright (C) 2016 The Qt Company Ltd.
  4. ** Contact: https://www.qt.io/licensing/
  5. **
  6. ** This file is part of the Qt Quick Controls module of the Qt Toolkit.
  7. **
  8. ** $QT_BEGIN_LICENSE:LGPL$
  9. ** Commercial License Usage
  10. ** Licensees holding valid commercial Qt licenses may use this file in
  11. ** accordance with the commercial license agreement provided with the
  12. ** Software or, alternatively, in accordance with the terms contained in
  13. ** a written agreement between you and The Qt Company. For licensing terms
  14. ** and conditions see https://www.qt.io/terms-conditions. For further
  15. ** information use the contact form at https://www.qt.io/contact-us.
  16. **
  17. ** GNU Lesser General Public License Usage
  18. ** Alternatively, this file may be used under the terms of the GNU Lesser
  19. ** General Public License version 3 as published by the Free Software
  20. ** Foundation and appearing in the file LICENSE.LGPL3 included in the
  21. ** packaging of this file. Please review the following information to
  22. ** ensure the GNU Lesser General Public License version 3 requirements
  23. ** will be met: https://www.gnu.org/licenses/lgpl-3.0.html.
  24. **
  25. ** GNU General Public License Usage
  26. ** Alternatively, this file may be used under the terms of the GNU
  27. ** General Public License version 2.0 or (at your option) the GNU General
  28. ** Public license version 3 or any later version approved by the KDE Free
  29. ** Qt Foundation. The licenses are as published by the Free Software
  30. ** Foundation and appearing in the file LICENSE.GPL2 and LICENSE.GPL3
  31. ** included in the packaging of this file. Please review the following
  32. ** information to ensure the GNU General Public License requirements will
  33. ** be met: https://www.gnu.org/licenses/gpl-2.0.html and
  34. ** https://www.gnu.org/licenses/gpl-3.0.html.
  35. **
  36. ** $QT_END_LICENSE$
  37. **
  38. ****************************************************************************/
  39. import QtQuick 2.2
  40. import QtQuick.Controls 1.2
  41. import QtQuick.Controls.Private 1.0
  42. /*!
  43. \qmltype BusyIndicator
  44. \inqmlmodule QtQuick.Controls
  45. \since 5.2
  46. \ingroup controls
  47. \brief A busy indicator.
  48. \image busyindicator.png
  49. The busy indicator should be used to indicate activity while content is
  50. being loaded or the UI is blocked waiting for a resource to become available.
  51. The following snippet shows how to use the BusyIndicator:
  52. \qml
  53. BusyIndicator {
  54. running: image.status === Image.Loading
  55. }
  56. \endqml
  57. You can create a custom appearance for a Busy Indicator by
  58. assigning a \l {BusyIndicatorStyle}.
  59. */
  60. Control {
  61. id: indicator
  62. /*! \qmlproperty bool BusyIndicator::running
  63. This property holds whether the busy indicator is currently indicating
  64. activity.
  65. \note The indicator is only visible when this property is set to \c true.
  66. The default value is \c true.
  67. */
  68. property bool running: true
  69. Accessible.role: Accessible.Indicator
  70. Accessible.name: "busy"
  71. style: Settings.styleComponent(Settings.style, "BusyIndicatorStyle.qml", indicator)
  72. }