Класс QProgressBar

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

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

Типы публичного доступа

Свойства

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

Функции публичного доступа

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

• 214 функций публичного доступа унаследовано от QWidget
• 34 функции публичного доступа унаследовано от QObject
• 14 функций публичного доступа унаследовано от QPaintDevice

Свойства доступа

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

Сигналы

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

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

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

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

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

• 1 публичная переменная унаследована от QObject
• 5 статические публичные члены унаследовано от QWidget
• 10 статических публичных членов унаследовано от QObject
• 1 защищенный слот унаследовано от QWidget
• 2 защищенные переменные унаследовано от QObject
• 1 защищенный тип унаследовано от QPaintDevice

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

Виджет 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.