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::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
プロパティのアクセス関数を再インプリメントします: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)
プログレスバーの最小値と最大値をそれぞれminimum とmaximum に設定します。
maximum がminimum より小さい場合、minimum が唯一の合法的な値となる。
現在の値が新しい範囲の外に出た場合、プログレス・バーはreset() でリセットされる。
QProgressBar は、setRange(0, 0) を使用することで、未確定状態に設定することができる。
[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.の 商標です。その他すべての商標は、それぞれの所有者に帰属します。