Класс QWinTaskbarProgress
Класс QWinTaskbarProgress представляет собой индикатор выполнения в системном трее Windows. Подробнее...
| Заголовок: | #include <QWinTaskbarProgress> |
| qmake: | QT += winextras |
| С момента: | Qt 5.2 |
| Наследует: | QObject |
Этот класс был добавлен в Qt 5.2.
Свойства
Открытые функции
| QWinTaskbarProgress(QObject *parent = nullptr) | |
| virtual | ~QWinTaskbarProgress() |
| bool | isPaused() const |
| bool | isStopped() const |
| bool | isVisible() const |
| int | maximum() const |
| int | minimum() const |
| int | value() const |
Открытые слоты
| void | hide() |
| void | pause() |
| void | reset() |
| void | resume() |
| void | setMaximum(int maximum) |
| void | setMinimum(int minimum) |
| void | setPaused(bool paused) |
| void | setRange(int minimum, int maximum) |
| void | setValue(int value) |
| void | setVisible(bool visible) |
| void | show() |
| void | stop() |
Сигналы
| void | maximumChanged(int maximum) |
| void | minimumChanged(int minimum) |
| void | pausedChanged(bool paused) |
| void | stoppedChanged(bool stopped) |
| void | valueChanged(int value) |
| void | visibilityChanged(bool visible) |
Подробное описание
Индикатор выполнения используется для отображения пользователю прогресса выполнения операции и для обеспечения того, что приложение всё ещё работает.
Индикатор выполнения использует понятие шагов. Он настраивается путём задания минимального и максимального значений шагов, и он будет отображать процент завершённых шагов, когда вы позже укажите текущее значение шага. Процент рассчитывается путём деления прогресса (value() - minimum()) на maximum() - minimum().
Минимальное и максимальное количество шагов можно задать, вызвав setMinimum() и setMaximum(). Текущее количество шагов устанавливается с помощью setValue(). Индикатор выполнения можно перемотать в начало с помощью reset().
Если минимальное и максимальное значения оба установлены в 0, индикатор отображается как индикатор выполнения (неопределённый) вместо процента шагов. Это полезно, когда невозможно определить количество шагов.
 |
Индикатор выполнения на 50%. |
 |
Приостановленный индикатор выполнения на 50%. |
 |
Остановленный индикатор выполнения на 50%. |
 |
Индикатор выполнения неопределённого типа. |
Примечание: Окончательный вид индикатора выполнения зависит от активной темы оформления Windows.
См. также QWinTaskbarButton.
END_OF_DOCUMENT_MARKERДокументация по свойствам
maximum : int
Это свойство хранит максимальное значение индикатора выполнения.
Значение по умолчанию — 100.
Функции доступа:
| int | maximum() const |
| void | setMaximum(int maximum) |
Сигнал уведомления:
| void | maximumChanged(int maximum) |
minimum : int
Это свойство хранит минимальное значение индикатора выполнения.
Значение по умолчанию — 0.
Функции доступа:
| int | minimum() const |
| void | setMinimum(int minimum) |
Сигнал уведомления:
| void | minimumChanged(int minimum) |
paused : bool
Это свойство указывает, приостановлен ли индикатор выполнения.
Значение по умолчанию — false.
Конечный вид приостановленного индикатора выполнения зависит от активной темы Windows. Обычно приостановленный индикатор выполнения становится жёлтым, чтобы указать, что выполнение временно приостановлено. В отличие от индикатора выполнения stopped, приостановленный индикатор не должен использоваться для обозначения ошибки.
Функции доступа:
| bool | isPaused() const |
| void | setPaused(bool paused) |
Сигнал уведомления:
| void | pausedChanged(bool paused) |
stopped : const bool
Это свойство указывает, остановлен ли индикатор выполнения.
Значение по умолчанию — false.
Конечный вид остановленного индикатора выполнения зависит от активной темы Windows. Обычно остановленный индикатор выполнения становится красным, чтобы указать, что выполнение полностью остановлено. В отличие от индикатора выполнения paused, остановленный индикатор может использоваться для обозначения ошибки.
Функции доступа:
| bool | isStopped() const |
Сигнал уведомления:
| void | stoppedChanged(bool stopped) |
value : int
Это свойство хранит текущее значение индикатора выполнения.
Значение по умолчанию — 0.
Функции доступа:
| int | value() const |
| void | setValue(int value) |
Сигнал уведомления:
| void | valueChanged(int value) |
visible : bool
Это свойство указывает, виден ли индикатор выполнения.
Значение по умолчанию — false.
Функции доступа:
| bool | isVisible() const |
| void | setVisible(bool visible) |
Сигнал уведомления:
| void | visibilityChanged(bool visible) |
Документация по функциям-членам
QWinTaskbarProgress::QWinTaskbarProgress(QObject *parent = nullptr)
Создаёт QWinTaskbarProgress с родительским объектом parent.
[slot] void QWinTaskbarProgress::hide()
Скрывает индикатор выполнения.
[slot] void QWinTaskbarProgress::pause()
Приостанавливает индикатор выполнения.
См. также paused.
[slot] void QWinTaskbarProgress::reset()
Сбрасывает индикатор выполнения.
Эта функция перематывает значение к минимальному значению.
[slot] void QWinTaskbarProgress::resume()
Возобновляет приостановленный или остановленный индикатор выполнения.
[slot] void QWinTaskbarProgress::setRange(int minimum, int maximum)
Устанавливает значения minimum и maximum.
[slot] void QWinTaskbarProgress::show()
Отображает индикатор выполнения.
[slot] void QWinTaskbarProgress::stop()
Останавливает индикатор выполнения.
См. также stopped.
[virtual] QWinTaskbarProgress::~QWinTaskbarProgress()
Удаляет QWinTaskbarProgress.
© The Qt Company Ltd
Licensed under the GNU Free Documentation License, Version 1.3.
https://doc.qt.io/qt-5.15/qwintaskbarprogress.html
