QProgressBar Class

QProgressBar ウィジェットは、水平または垂直のプログレスバーを提供します。詳細...

Header: #include <QProgressBar>
CMake: find_package(Qt6 REQUIRED COMPONENTS Widgets)
target_link_libraries(mytarget PRIVATE Qt6::Widgets)
qmake: QT += widgets
Inherits: 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::TopToBottom0テキストは時計回りに90度回転される。
QProgressBar::BottomToTop1テキストは反時計回りに 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

プロパティのアクセス関数を再インプリメントします:QWidget::minimumSizeHint

[override virtual protected] void QProgressBar::paintEvent(QPaintEvent *)

再実装:QWidget::paintEvent(QPaintEvent *event)。

[slot] void QProgressBar::reset()

プログレスバーをリセットします。プログレスバーは "巻き戻し "され、進捗は表示されなくなります。

[slot] void QProgressBar::setRange(int minimum, int maximum)

プログレスバーの最小値と最大値をそれぞれminimummaximum に設定します。

maximumminimum より小さい場合、minimum が唯一の合法的な値となる。

現在の値が新しい範囲の外に出た場合、プログレス・バーはreset() でリセットされる。

QProgressBar は、setRange(0, 0) を使用することで、未確定状態に設定することができる。

minimum およびmaximumも参照のこと

[override virtual] QSize QProgressBar::sizeHint() const

プロパティのアクセス関数を再実装:QWidget::sizeHint

[signal] void QProgressBar::valueChanged(int value)

このシグナルは、プログレス・バーに表示される値が変更されたときに発せられます。value は、プログレス・バーに表示される新しい値です。

注: プロパティ用のノーティファイアシグナルvalue

本ドキュメントに含まれる文書の著作権は、それぞれの所有者に帰属します。 本書で提供されるドキュメントは、Free Software Foundation が発行したGNU Free Documentation License version 1.3に基づいてライセンスされています。 Qtおよびそれぞれのロゴは、フィンランドおよびその他の国におけるThe Qt Company Ltd.の 商標です。その他すべての商標は、それぞれの所有者に帰属します。