このページでは

ProgressBar QML Type

操作の進行状況を示す。詳細...

Import Statement: import QtQuick.Controls
Inherits:

Control

プロパティ

詳細説明

ProgressBarは操作の進行状況を示す。値は定期的に更新されるべきである。範囲はfromto で定義され、どちらも任意の値を含むことができる。

ProgressBar {
    value: 0.5
}

ProgressBar は、特別なindeterminate モードもサポートしている。これは、ダウンロード中のアイテムのサイズを判断できない場合や、ネットワークの切断によってダウンロードの進行が中断された場合などに便利である。

ProgressBar {
    indeterminate: true
}

不確定モードは、BusyIndicator に似ている。 どちらも、バックグラウンドでの活動を示すのに使用できる。主な違いは視覚的なもので、ProgressBarは具体的な進捗量を表示することもできる(決定できる場合)。視覚的な違いにより、不確定プログレス・バーとビジー・インジケータは、ユーザー・インターフェースの異なる場所に適合します。不確定プログレスバーの典型的な場所

  • の下部ToolBar
  • のコンテンツ内のインラインPage
  • ItemDelegate 、特定のアイテムの進行状況を表示する。

ProgressBarBusyIndicatorインジケータ・コントロールのカスタマイズも参照して ください。

プロパティ・ドキュメント

from : real

このプロパティは進捗の開始値を保持する。デフォルト値は0.0 です。

to およびvalueも参照してください

indeterminate : bool

このプロパティは、プログレスバーが不確定モードであるかどうかを保持する。不確定モードのプログレス・バーは、操作が進行中であることを表示するが、どの程度進行したかは表示しない。

position : real [read-only]

このプロパティは進捗の論理位置を保持する。

この位置は、0.0 - 1.0 の範囲で、値の端数として表現されます。進行状況を視覚化するには、右から左を意識したvisualPosition を代わりに使用する必要があります。

value およびvisualPositionも参照して ください。

to : real

このプロパティは進捗の終了値を保持する。デフォルト値は1.0 です。

from およびvalueも参照してください

value : real

このプロパティは進捗値を保持する。デフォルト値は0.0 である。

fromtopositionも参照してください

visualPosition : real [read-only]

このプロパティは、進行の視覚的位置を保持する。

この位置は、0.0 - 1.0 の範囲内で、値の端数として表現される。コントロールがmirrored の場合、visuaPosition1.0 - position と等しくなります。このため、visualPosition は右から左へのサポートを考慮した進行状況の視覚化に適しています。

position およびvalueも参照のこと

© 2026 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.