Класс QProgressBar

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

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

Типы

Свойства

• 58 свойств, унаследованных от QWidget
• 1 свойство, унаследованное от QObject

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

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

• 211 открытых функций, унаследованных от QWidget
• 31 открытых функций, унаследованных от QObject
• 14 открытых функций, унаследованных от QPaintDevice

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

• 19 открытых слотов, унаследованных от QWidget
• 1 открытый слот, унаследованный от QObject

Сигналы

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

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

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

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

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

• 5 статических открытых членов, унаследованных от QWidget
• 11 статических открытых членов, унаследованных от QObject
• 1 защищенный слот, унаследованный от QWidget

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

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

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

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

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

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

	Полоса прогресса, отображаемая в стиле виджета Macintosh.
	Полоса прогресса, отображаемая в стиле виджета Windows Vista.
	Полоса прогресса, отображаемая в стиле виджета Fusion.

См. также QProgressDialog и Справочник по проектированию пользовательского интерфейса: индикатор выполнения.

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

enum QProgressBar::Direction

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

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

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

См. также textDirection.

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

QProgressBar::QProgressBar(QWidget *parent = Q_NULLPTR)

Создаёт полосу прогресса с заданным родительским элементом parent.

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

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

QProgressBar::~QProgressBar()

Деструктор.

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

Переопределено из QObject::event().

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

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

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

[virtual] QSize QProgressBar::minimumSizeHint() const

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

[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.

[virtual] QSize QProgressBar::sizeHint() const

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

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

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

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