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も参照のこと


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