BusyIndicator QML Type

Indicates background activity, for example, while content is being loaded. More...

Import Statement: import QtQuick.Controls 2.3
Since: Qt 5.7



Detailed Description

The busy indicator should be used to indicate activity while content is being loaded or the UI is blocked waiting for a resource to become available.

The following snippet shows how to use the BusyIndicator:

BusyIndicator {
    running: image.status === Image.Loading

BusyIndicator is similar to an indeterminate ProgressBar. Both can be used to indicate background activity. The main difference is visual, and that ProgressBar can also present a concrete amount of progress (when it can be determined). Due to the visual difference, busy indicators and indeterminate progress bars fit different places in user interfaces. Typical places for a busy indicator:

See also Customizing BusyIndicator, Indicator Controls, and ProgressBar.

Property Documentation

running : bool

This property holds whether the busy indicator is currently indicating activity.

Note: The indicator is only visible when this property is set to true.

The default value is true.

© 2018 The Qt Company Ltd. Documentation contributions included herein are the copyrights of their respective owners. The documentation provided herein is licensed under the terms of the GNU Free Documentation License version 1.3 as published by the Free Software Foundation. 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.