Класс QAbstractSlider

Класс QAbstractSlider предоставляет целое значение в заданном диапазоне. Подробнее...

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

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

Свойства

Публичные функции

Свойства публичного доступа

Сигналы

Защищенные типы

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

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

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

Класс разработан как общий базовый класс для виджетов, таких как QScrollBar, QSlider и QDial.

Вот основные свойства класса:

1. значение: Целое число, которое QAbstractSlider сохраняет в границах.
2. минимальное значение: Наименьшее возможное значение.
3. максимальное значение: Наибольшее возможное значение.
4. шаг: Меньший из двух естественных шагов, которые предоставляет абстрактный ползунок, и обычно соответствует нажатию пользователем клавиши со стрелкой.
5. шаг страницы: Больший из двух естественных шагов, которые предоставляет абстрактный ползунок, и обычно соответствует нажатию пользователем клавиш PageUp или PageDown.
6. отслеживание: Включено ли отслеживание ползунка.
7. положение ползунка: Текущее положение ползунка. Если отслеживание включено (по умолчанию), оно идентично значению значение.

Единица (1) может рассматриваться как третий размер шага. setValue() позволяет установить текущее значение на любое целое число в разрешенном диапазоне, а не только минимальное значение() + n * шаг() для целых значений n. Некоторые виджеты могут позволить пользователю устанавливать любое значение вообще; другие могут предоставлять только кратные значения шага или шага страницы.

QAbstractSlider испускает полный набор сигналов:

QAbstractSlider предоставляет виртуальную функцию sliderChange(), которая хорошо подходит для обновления визуального представления ползунков на экране. Вызвав triggerAction(), подклассы запускают действия ползунка. Две вспомогательные функции QStyle::sliderPositionFromValue() и QStyle::sliderValueFromPosition() помогают подклассам и стилям сопоставлять координаты экрана с логическими значениями диапазона.

См. такжеQAbstractSpinBox, QSlider, QDial, QScrollBar и Пример ползунков.

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

перечисление QAbstractSlider::SliderAction

перечисление QAbstractSlider::SliderChange

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

QAbstractSlider::QAbstractSlider(QWidget *parent = nullptr)

Конструирует абстрактный ползунок.

Аргумент parent передается конструктору QWidget.

По умолчанию минимальное значение равно 0, максимальное — 99, размер singleStep — 1, размер pageStep — 10, начальное значение value — 0.

[signal] void QAbstractSlider::actionTriggered(int action)

Этот сигнал испускается при срабатывании действия ползунка action. Действия — SliderSingleStepAdd, SliderSingleStepSub, SliderPageStepAdd, SliderPageStepSub, SliderToMinimum, SliderToMaximum и SliderMove.

При выводе сигнала, sliderPosition был откорректирован в соответствии с действием, но значение ещё не было распространено (что означает, что сигнал valueChanged() ещё не был выведен), и визуальное отображение ещё не обновлено. В слотах, подключенных к этому сигналу, вы можете безопасно отрегулировать любое действие, вызвав setSliderPosition() самостоятельно, основываясь на действии и значении ползунка.

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

[signal] void QAbstractSlider::rangeChanged(int min, int max)

Этот сигнал генерируется при изменении диапазона ползунка, где min — новое минимальное значение, а max — новое максимальное значение.

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

[slot] void QAbstractSlider::setRange(int min, int max)

Устанавливает минимальное значение ползунка в min, а максимальное — в max.

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

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

[signal] void QAbstractSlider::sliderMoved(int value)

Этот сигнал генерируется, когда sliderDown имеет значение true и ползунок перемещается. Обычно это происходит, когда пользователь перетаскивает ползунок. Значение value — новая позиция ползунка.

Этот сигнал генерируется даже при отключенном отслеживании.

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

См. также setTracking(), valueChanged(), isSliderDown(), sliderPressed() и sliderReleased().

[signal] void QAbstractSlider::sliderPressed()

Этот сигнал генерируется, когда пользователь нажимает на ползунок мышкой или программно, когда вызывается setSliderDown(true).

См. также sliderReleased(), sliderMoved() и isSliderDown().

[signal] void QAbstractSlider::sliderReleased()

Этот сигнал генерируется, когда пользователь отпускает ползунок мышкой или программно, когда вызывается setSliderDown(false).

См. также sliderPressed(), sliderMoved() и sliderDown.

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

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

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

[virtual] QAbstractSlider::~QAbstractSlider()

Удаляет ползунок.

[override virtual protected] void QAbstractSlider::changeEvent(QEvent *ev)

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

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

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

[override virtual protected] void QAbstractSlider::keyPressEvent(QKeyEvent *ev)

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

[protected] QAbstractSlider::SliderAction QAbstractSlider::repeatAction() const

Возвращает текущее действие повтора.

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

[protected] void QAbstractSlider::setRepeatAction(QAbstractSlider::SliderAction action, int thresholdTime = 500, int repeatTime = 50)

Устанавливает действие action для повторного срабатывания через интервалы repeatTime после начальной задержки thresholdTime.

См. также triggerAction() и repeatAction().

[virtual protected] void QAbstractSlider::sliderChange(QAbstractSlider::SliderChange change)

Переопределите эту виртуальную функцию для отслеживания изменений ползунка, таких как SliderRangeChange, SliderOrientationChange, SliderStepsChange или SliderValueChange. По умолчанию выполняется только обновление отображения и параметр change игнорируется.

[override virtual protected] void QAbstractSlider::timerEvent(QTimerEvent *e)

Переопределяет: QObject::timerEvent(QTimerEvent *event).

void QAbstractSlider::triggerAction(QAbstractSlider::SliderAction action)

Вызывает действие ползунка action. Возможные действия: SliderSingleStepAdd, SliderSingleStepSub, SliderPageStepAdd, SliderPageStepSub, SliderToMinimum, SliderToMaximum и SliderMove.

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

[override virtual protected] void QAbstractSlider::wheelEvent(QWheelEvent *e)

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