Класс 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 |
- 32 открытые функции унаследованы от 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.
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) |
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/qt-5.9/qwintaskbarprogress.html
