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