QProgressBar Class
QProgressBar ウィジェットは、水平または垂直のプログレスバーを提供します。詳細...
| ヘッダ | #include <QProgressBar> |
| CMake： | find_package(Qt6 REQUIRED COMPONENTS Widgets)target_link_libraries(mytarget PRIVATE Qt6::Widgets) |
| qmake： | QT += widgets |
| 継承： | QWidget |
パブリックな型
| enum | Direction { TopToBottom, BottomToTop } |
プロパティ
|
|
パブリック関数
| QProgressBar(QWidget *parent = nullptr) | |
| virtual | ~QProgressBar() |
| Qt::Alignment | alignment() const |
| QString | format() const |
| bool | invertedAppearance() const |
| bool | isTextVisible() const |
| int | maximum() const |
| int | minimum() const |
| Qt::Orientation | orientation() const |
| void | resetFormat() |
| void | setAlignment(Qt::Alignment alignment) |
| void | setFormat(const QString &format) |
| void | setInvertedAppearance(bool invert) |
| void | setTextDirection(QProgressBar::Direction textDirection) |
| void | setTextVisible(bool visible) |
| virtual QString | text() const |
| QProgressBar::Direction | textDirection() const |
| int | value() const |
再実装パブリック関数
| virtual QSize | minimumSizeHint() const override |
| virtual QSize | sizeHint() const override |
パブリック・スロット
| void | reset() |
| void | setMaximum(int maximum) |
| void | setMinimum(int minimum) |
| void | setOrientation(Qt::Orientation) |
| void | setRange(int minimum, int maximum) |
| void | setValue(int value) |
シグナル
| void | valueChanged(int value) |
保護された関数
| virtual void | initStyleOption(QStyleOptionProgressBar *option) const |
再実装された保護された関数
| virtual bool | event(QEvent *e) override |
| virtual void | paintEvent(QPaintEvent *) override |
詳細説明
プログレスバーは、ユーザーに操作の進行状況を示し、アプリケーションがまだ実行中であることを安心させるために使われます。
プログレス・バーはステップの概念を使用します。可能なステップの最小値と最大値を指定して設定し、後で現在のステップ値を与えると、完了したステップのパーセンテージが表示されます。パーセンテージは、進捗率（value() -minimum() ）をmaximum() -minimum() で割って算出される。
最小ステップ数と最大ステップ数はsetMinimum() とsetMaximum で指定できます。現在のステップ数はsetValue() で設定します。プログレス・バーはreset() で最初に巻き戻すことができる。
最小値と最大値の両方を 0 に設定すると、バーには歩数のパーセンテージの代わりにビジー・ インジケータが表示される。これは、QNetworkAccessManager を使用してアイテムをダウンロードする際に、ダウンロード中のアイテムのサイズを判断できない場合などに便利である。
QProgressDialogも参照の こと。
メンバー・タイプ・ドキュメント
enum QProgressBar::Direction
垂直プログレスバーのtext の読み取り方向を指定する。
| 定数 | 値 | 説明 |
|---|---|---|
QProgressBar::TopToBottom | 0 | テキストは時計回りに90度回転します。 |
QProgressBar::BottomToTop | 1 | テキストは反時計回りに 90 度回転します。 |
テキストが描画されるかどうかはスタイルに依存することに注意。現在、CleanLooks と Plastique はテキストを描画します。Mac ・ Windows ・ WindowsVista スタイルはテキストを描画しません。
textDirectionも参照してください 。
プロパティ文書
alignment : Qt::Alignment
このプロパティは、プログレスバーのアライメントを保持する。
アクセス関数です：
| Qt::Alignment | alignment() const |
| void | setAlignment(Qt::Alignment alignment) |
format : QString
このプロパティは、現在のテキストを生成するために使用される文字列を保持する。
p - 完了したパーセンテージで置き換えられます。v - 現在の値に置き換えられます。m - ステップの合計数に置き換えられます。
デフォルト値は"%p%"です。
アクセス関数：
| QString | format() const |
| void | setFormat(const QString &format) |
| void | resetFormat() |
text()も参照してください 。
invertedAppearance : bool
このプロパティは、プログレス・バーがその進捗を反転して表示するかどうかを保持する。
このプロパティがtrue の場合、プログレス・バーは反対方向（例えば右から左へ）に成長する。デフォルトでは、プログレスバーは反転しません。
アクセス関数：
| bool | invertedAppearance() const |
| void | setInvertedAppearance(bool invert) |
orientation およびlayoutDirectionも参照してください 。
maximum : int
このプロパティは、プログレスバーの最大値を保持します。
このプロパティを設定するとき、minimum は、範囲が有効なままであることを保証するために、必要に応じて調整される。現在値が新しい範囲から外れる場合、プログレス・バーはreset() でリセットされる。
アクセス関数：
| int | maximum() const |
| void | setMaximum(int maximum) |
minimum : int
このプロパティは、プログレスバーの最小値を保持します。
このプロパティを設定するとき、maximum は、範囲が有効なままであることを保証するために、必要に応じて調整されます。現在値が新しい範囲から外れる場合、プログレス・バーはreset() でリセットされる。
アクセス関数：
| int | minimum() const |
| void | setMinimum(int minimum) |
orientation : Qt::Orientation
このプロパティは、プログレスバーの向きを保持します。
向きはQt::Horizontal (デフォルト) またはQt::Vertical でなければなりません。
アクセス関数：
| Qt::Orientation | orientation() const |
| void | setOrientation(Qt::Orientation) |
invertedAppearance およびtextDirectionも参照してください 。
[read-only] text : const QString
このプロパティは、プログレスバーと共に表示される説明テキストを保持する。
返されるテキストは、プログレスバーの中央（またはいくつかのスタイルでは左側）に表示されるテキストと同じです。
テキストに表示される進捗は、進捗が設定される前にプログレスバーが "リセット "状態にあることを示す最小値よりも小さいかもしれません。
デフォルトの実装では、テキストにはこれまでの進捗を示すパーセンテージ値が含まれるか、プログレスバーがリセット状態にあるため空白になります。
関数にアクセスします：
| virtual QString | text() const |
textDirection : Direction
このプロパティは、垂直プログレスバーのtext の読み取り方向を保持する。
このプロパティは水平プログレス・バーには影響しません。デフォルトでは、読み取り方向はQProgressBar::TopToBottom です。
アクセス関数：
| QProgressBar::Direction | textDirection() const |
| void | setTextDirection(QProgressBar::Direction textDirection) |
orientation およびtextVisibleも参照 。
textVisible : bool
このプロパティは、現在の完了パーセンテージを表示するかどうかを保持します。
このプロパティは、スタイルによって無視される場合があります（例えば、QMacStyleはテキストを描画しません）。
アクセス関数：
| bool | isTextVisible() const |
| void | setTextVisible(bool visible) |
textDirectionも参照してください 。
value : int
このプロパティは、プログレスバーの現在値を保持する。
現在値を最小値から最大値の範囲外に変更しようとしても、現在値には影響しません。
アクセス関数
| int | value() const |
| void | setValue(int value) |
ノーティファイアシグナル：
| void | valueChanged(int value) |
メンバ関数ドキュメント
[explicit] QProgressBar::QProgressBar(QWidget *parent = nullptr)
与えられたparent でプログレスバーを構築する。
デフォルトでは、ステップの最小値は 0、最大値は 100 に設定されます。
setRange()も参照 。
[virtual noexcept] QProgressBar::~QProgressBar()
破壊者。
[override virtual protected] bool QProgressBar::event(QEvent *e)
再実装：QWidget::event(QEvent *event)。
[virtual protected] void QProgressBar::initStyleOption(QStyleOptionProgressBar *option) const
QProgressBar の値でoption を初期化する。このメソッドは、サブクラスがQStyleOptionProgressBar を必要とするが、すべての情報を自分で入力したくない場合に便利です。
QStyleOption::initFrom()も参照 。
[override virtual] QSize QProgressBar::minimumSizeHint() const
[override virtual protected] void QProgressBar::paintEvent(QPaintEvent *)
再実装：QWidget::paintEvent(QPaintEvent *event)。
[slot] void QProgressBar::reset()
プログレスバーをリセットしてください。プログレスバーが「巻き戻し」され、進捗が表示されなくなる。
[slot] void QProgressBar::setRange(int minimum, int maximum)
プログレスバーの最小値と最大値をそれぞれminimum とmaximum に設定する。
maximum がminimum より小さい場合、minimum が唯一の有効な値となる。
現在の値が新しい範囲から外れる場合、プログレス・バーはreset() でリセットされる。
QProgressBar は、setRange(0, 0) を使用することで、未確定状態に設定することができる。
[override virtual] QSize QProgressBar::sizeHint() const
[signal] void QProgressBar::valueChanged(int value)
このシグナルは、プログレスバーに表示される値が変更されたときに発行される。value は、プログレスバーに表示される新しい値である。
注: プロパティ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.
