MeeGo 1.2 Harmattan Developer Documentation Develop for the Nokia N9

QML ProgressBar Element

Indicates work happening in the program. More...

Inherits Item

This element was introduced in qt-components 4.7.

Properties

Detailed Description

A ProgressBar shows the continuing progress of a long-running operation to reassure the user that the operation is still progressing.

Some operations take a period of time to be performed and the user needs confirmation that the operation is still ongoing. If the user does not get any confirmation they may suspect that they did something wrong or that the device has broken. A progress bar is one of the mechanisms available for providing this reassurance to the user.

ProgressBar has two presentation modes:

  • Determinate for when the period of time for the operation can be measured. In this case, the progress bar shows the proportion of progress.
  • Indeterminate for when the period of time for the operation is unknown. The progress bar is animated but no proportion of progress is indicated.

The following code snippet creates a progress bar and demonstrates how the progress bar works:

 ProgressBar {
     id: progressBar
     width: 300
     minimumValue: 0
     maximumValue: 100
     value: 50
 }

 ProgressBar {
     id: progressBar2
     width: 300
     indeterminate: true
     value: 50
 }

Property Documentation

indeterminate : bool

Property default is false.

Turn on the unknown duration state.


maximumValue : real

Property default is 1.0.

Specifies the maximum value of progress (done).


minimumValue : real

Property default is 0.0.

Specifies the minimum value of progress.


value. : real

Specifies the current value of progress.