Класс QProgressBar

Виджет QProgressBar предоставляет горизонтальную или вертикальную полосу прогресса. Подробнее...

• Список всех членов, включая унаследованные

Общедоступные типы

Свойства

Общедоступные функции

Переопределенные общедоступные функции

Общедоступные слоты

Сигналы

Защищенные функции

Реализованные защищенные функции

Подробное описание

Полоса прогресса используется для отображения пользователю хода выполнения операции и для того, чтобы убедиться, что приложение всё ещё работает.

Полоса прогресса использует понятие шагов. Вы настраиваете её, указывая минимальное и максимальное значения шагов, и она будет отображать процент завершённых шагов, когда вы позже укажете текущее значение шага. Процент вычисляется путём деления прогресса (значение() - минимальное()) на максимальное() - минимальное().

Вы можете указать минимальное и максимальное количество шагов с помощью setMinimum() и setMaximum. Текущее количество шагов устанавливается с помощью setValue(). Полоса прогресса может быть перемотана в начало с помощью reset().

Если минимальное и максимальное значения оба установлены в 0, полоса отображает индикатор активности вместо процента завершённых шагов. Это полезно, например, при использовании QNetworkAccessManager для загрузки элементов, когда невозможно определить размер загружаемого элемента.

См. также QProgressDialog и Руководство по разработке пользовательского интерфейса: Индикатор прогресса.

Документация по типам членов

enum QProgressBar::Direction

Указывает направление чтения текста для вертикальных полос прогресса.

Обратите внимание, что вывод текста зависит от стиля. В настоящее время стили CleanLooks и Plastique выводят текст. Стили Mac, Windows и WindowsVista не выводят.

Этот перечисление был введён или изменён в Qt 4.1.

См. также textDirection.

Документация по членам-функциям

QProgressBar::QProgressBar(QWidget *parent = nullptr)

Конструирует полосу прогресса с заданным parent.

По умолчанию минимальное значение шага установлено в 0, а максимальное - в 100.

См. также setRange().

[slot] void QProgressBar::reset()

Сбрасывает полосу прогресса. Полоса прогресса "сбрасывается" и не показывает прогресс.

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

Устанавливает минимальное и максимальное значения полосы прогресса соответственно на minimum и maximum.

Если maximum меньше minimum, minimum становится единственным допустимым значением.

Если текущее значение выходит за пределы нового диапазона, полоса прогресса сбрасывается с помощью reset().

Полоса прогресса может быть установлена в неопределенное состояние, используя setRange(0, 0).

См. также minimum и maximum.

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

Данный сигнал генерируется, когда значение, отображаемое на полосе прогресса, изменяется. value - новое значение, отображаемое полосой прогресса.

Примечание: Сигнал уведомления для свойства value.

[virtual] QProgressBar::~QProgressBar()

Деструктор.

[override virtual protected] bool QProgressBar::event(QEvent *e)

Переопределяет: QWidget::event(QEvent *event).

[protected] void QProgressBar::initStyleOption(QStyleOptionProgressBar *option) const

Инициализировать option значениями из этого QProgressBar. Этот метод полезен для подклассов, когда им нужен QStyleOptionProgressBar, но они не хотят заполнять всю информацию самостоятельно.

См. также QStyleOption::initFrom().

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

Переопределяет функцию доступа к свойству: QWidget::minimumSizeHint.

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

Переопределяет: QWidget::paintEvent(QPaintEvent *event).

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

Переопределяет функцию доступа к свойству: QWidget::sizeHint.