ProgressBar QML Type
操作の進行状況を示します。詳細...
| Import Statement: | import QtQuick.Controls |
| Inherits: |
プロパティ
- from : real
- indeterminate : bool
- position : real
- to : real
- value : real
- visualPosition : real
詳細な説明
ProgressBarは、操作の進行状況を示します。値は定期的に更新される必要があります。範囲はfrom およびto によって定義され、どちらも任意の値を指定できます。
ProgressBar {
value: 0.5
}ProgressBar は、特別な「indeterminate 」モードもサポートしています。これは、たとえば、ダウンロード中のアイテムのサイズが特定できない場合や、ネットワーク切断によってダウンロードの進行が中断された場合などに役立ちます。
ProgressBar {
indeterminate: true
}不確定モードは「BusyIndicator 」に似ています。どちらもバックグラウンドでの処理を示唆するために使用できます。 主な違いは視覚的な点にあり、ProgressBarは(確定可能な場合)具体的な進行状況も表示できます。この視覚的な違いにより、不確定な進行状況を示すプログレスバーとビジーインジケーターは、ユーザーインターフェース上の配置場所が異なります。不確定なプログレスバーの典型的な配置場所:
- コンテンツ内のToolBar
- xml-ph-0000@deepl.internal内のコンテンツ内にインラインで配置され、Page
- ItemDelegate 内で特定の項目の進行状況を表示する場合
「ProgressBar」、「BusyIndicator 」、および「Indicator」コントロールのカスタマイズも参照してください 。
プロパティのドキュメント
from : real
このプロパティは、進行状況の初期値を保持します。デフォルト値は `0.0` です。
indeterminate : bool
このプロパティは、プログレスバーが不定モードであるかどうかにかかわらず有効です。不定モードのプログレスバーは、操作が進行中であることを表示しますが、進行状況の進捗率は表示しません。
position : real [read-only]
このプロパティは、進行状況の論理的な位置を保持します。
位置は、0.0 - 1.0 の範囲内で、値に対する割合として表されます。進行状況を可視化するには、代わりに右から左への読み込みに対応したvisualPosition を使用する必要があります。
「 value 」および「visualPosition 」も参照してください 。
to : real
このプロパティには、進行状況の終了値が格納されます。デフォルト値は `1.0` です。
「 from 」および「value 」も参照してください 。
value : real
このプロパティは進行状況の値を保持します。デフォルト値は `0.0` です。
「 from 」、「to 」、および「position 」も参照してください 。
visualPosition : real [read-only]
このプロパティは、プログレスの表示位置を保持します。
位置は、0.0 - 1.0 の範囲内で、値の分数として表されます。コントロールがmirrored の場合、visuaPosition は1.0 - position に等しくなります。これにより、visualPosition は、右から左への表示に対応した進行状況の可視化に適しています。
© 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.