Класс QProgressBar

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

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

Открытые типы

Свойства

Открытые функции

Переопределённые открытые функции

Открытые слоты

Сигналы

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

Переопределённые защищённые функции

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

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

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

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

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

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

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

перечисление 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.