内容

• 特性
• 详细描述

ProgressBar QML Type

Indicates the progress of an operation. 更多...

import 语句：	import QtQuick.Controls 2.5
Since:	Qt 5.7
继承：	Control

• 所有成员列表，包括继承成员

特性

• from : real
• indeterminate : bool
• position : real
• to : real
• value : real
• visualPosition : real

详细描述

ProgressBar indicates the progress of an operation. The value should be updated regularly. The range is defined by from and to , which both can contain any value.

ProgressBar {
    value: 0.5
}
					

ProgressBar also supports a special indeterminate mode, which is useful, for example, when unable to determine the size of the item being downloaded, or if the download progress gets interrupted due to a network disconnection.

ProgressBar {
    indeterminate: true
}
					

The indeterminate mode is similar to a BusyIndicator . 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, indeterminate progress bars and busy indicators fit different places in user interfaces. Typical places for an indeterminate progress bar:

• at the bottom of a ToolBar
• inline within the content of a Page
• in an ItemDelegate to show the progress of a particular item

另请参阅 Customizing ProgressBar , BusyIndicator ，和 指示器控件 .

特性文档编制

from : real

This property holds the starting value for the progress. The default value is 0.0 .

另请参阅 to and value .

indeterminate : bool

This property holds whether the progress bar is in indeterminate mode. A progress bar in indeterminate mode displays that an operation is in progress, but it doesn't show how much progress has been made.

[read-only] position : real

This property holds the logical position of the progress.

The position is expressed as a fraction of the value, in the range 0.0 - 1.0 . For visualizing the progress, the right-to-left aware visualPosition 应该被使用以取而代之。

另请参阅 value and visualPosition .

to : real

This property holds the end value for the progress. The default value is 1.0 .

另请参阅 from and value .

value : real

This property holds the progress value. The default value is 0.0 .

另请参阅 from , to ，和 position .

[read-only] visualPosition : real

This property holds the visual position of the progress.

The position is expressed as a fraction of the value, in the range 0.0 - 1.0 . When the control is mirrored , visuaPosition 等于 1.0 - position . This makes visualPosition suitable for visualizing the progress, taking right-to-left support into account.

另请参阅 position and value .