Класс QProgressBar

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

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

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

Свойства

• 59 свойств унаследовано от QWidget
• 1 свойство унаследовано от QObject

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

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

• 214 общедоступных функций унаследовано от QWidget
• 31 общедоступная функция унаследована от QObject
• 14 общедоступных функций унаследовано от QPaintDevice

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

• 19 общедоступных слотов унаследовано от QWidget
• 1 общедоступный слот унаследован от QObject

Сигналы

• 3 сигнала унаследованных от QWidget
• 2 сигнала унаследованных от QObject

Статические публичные члены

• 5 статических публичных членов унаследованных от QWidget
• 9 статических публичных членов унаследованных от QObject

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

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

• 35 защищенных функций унаследованных от QWidget
• 9 защищенных функций унаследованных от QObject
• 1 защищенная функция унаследованная от QPaintDevice

Дополнительные унаследованные члены

• 1 защищенный слот унаследованный от QWidget

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

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

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

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

Вы можете указать минимальное и максимальное количество шагов с помощью 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().

[virtual] QProgressBar::~QProgressBar()

Деструктор.

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

Переопределено из QWidget::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().

[slot] void QProgressBar::reset()

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

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

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

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

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

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

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

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

Переопределено из QWidget::sizeHint().

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

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

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