Класс QProgressBar

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

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

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

Свойства

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

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

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

Сигналы

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

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

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

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

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

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

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

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

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

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

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

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

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

Переопределяет: QWidget::minimumSizeHint() const.

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

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

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

Переопределяет: QWidget::sizeHint() const.