Класс QAbstractSlider
Класс QAbstractSlider предоставляет целое значение в заданном диапазоне. Подробнее...
| Заголовок: | #include <QAbstractSlider> |
| qmake: | QT += widgets |
| Наследует: | QWidget |
| Наследуется от: |
Открытые типы
| перечисление | SliderAction { SliderNoAction, SliderSingleStepAdd, SliderSingleStepSub, SliderPageStepAdd, ..., SliderMove } |
Свойства
|
|
Открытые функции
| QAbstractSlider(QWidget *parent = Q_NULLPTR) | |
| ~QAbstractSlider() | |
| bool | hasTracking() const |
| bool | invertedAppearance() const |
| bool | invertedControls() const |
| bool | isSliderDown() const |
| int | maximum() const |
| int | minimum() const |
| Qt::Orientation | orientation() const |
| int | pageStep() const |
| void | setInvertedAppearance(bool) |
| void | setInvertedControls(bool) |
| void | setMaximum(int) |
| void | setMinimum(int) |
| void | setPageStep(int) |
| void | setSingleStep(int) |
| void | setSliderDown(bool) |
| void | setSliderPosition(int) |
| void | setTracking(bool enable) |
| int | singleStep() const |
| int | sliderPosition() const |
| void | triggerAction(SliderAction action) |
| int | value() const |
- 214 открытых функций, унаследованных от QWidget
- 32 открытых функции, унаследованных от QObject
- 14 открытых функций, унаследованных от QPaintDevice
Открытые слоты
| void | setOrientation(Qt::Orientation) |
| void | setRange(int min, int max) |
| void | setValue(int) |
Сигналы
| void | actionTriggered(int action) |
| void | rangeChanged(int min, int max) |
| void | sliderMoved(int value) |
| void | sliderPressed() |
| void | sliderReleased() |
| void | valueChanged(int value) |
Защищенные типы
| перечисление | SliderChange { SliderRangeChange, SliderOrientationChange, SliderStepsChange, SliderValueChange } |
Защищенные функции
| SliderAction | repeatAction() const |
| void | setRepeatAction(SliderAction action, int thresholdTime = 500, int repeatTime = 50) |
| virtual void | sliderChange(SliderChange change) |
Переопределенные защищенные функции
| virtual void | changeEvent(QEvent *ev) |
| virtual bool | event(QEvent *e) |
| virtual void | keyPressEvent(QKeyEvent *ev) |
| virtual void | timerEvent(QTimerEvent *e) |
| virtual void | wheelEvent(QWheelEvent *e) |
- 35 защищенных функций унаследовано от QWidget
- 9 защищенных функций унаследовано от QObject
- 1 защищенная функция унаследовано от QPaintDevice
Дополнительные унаследованные члены
- 5 статических публичных членов унаследовано от QWidget
- 11 статических публичных членов унаследовано от QObject
- 1 защищённый слот унаследовано от QWidget
Подробное описание
Класс QAbstractSlider предоставляет целое значение в определённом диапазоне.
Класс разработан как общий базовый класс для виджетов, таких как QScrollBar, QSlider и QDial.
Вот основные свойства класса:
- value: Целое число в пределах диапазона, которое поддерживает QAbstractSlider.
- minimum: Наименьшее возможное значение.
- maximum: Наибольшее возможное значение.
- singleStep: Меньший из двух естественных шагов, предоставляемых абстрактной ползунковой шкалой, и обычно соответствует нажатию клавиши со стрелкой.
- pageStep: Больший из двух естественных шагов, предоставляемых абстрактной ползунковой шкалой, и обычно соответствует нажатию клавиш PageUp или PageDown.
- tracking: Включено ли отслеживание ползунка.
- sliderPosition: Текущее положение ползунка. Если tracking включено (по умолчанию), это идентично value.
Единица (1) может рассматриваться как третий размер шага. setValue() позволяет установить текущее значение на любое целое число в допустимом диапазоне, а не только minimum() + n * singleStep() для целых значений n. Некоторые виджеты могут позволять пользователю устанавливать любое значение; другие могут предоставлять только кратные singleStep() или pageStep().
QAbstractSlider излучает полный набор сигналов:
| Сигнал | Излучается при |
|---|---|
| valueChanged() | значение изменилось. tracking определяет, излучается ли этот сигнал во время взаимодействия пользователя. |
| sliderPressed() | пользователь начинает перетаскивать ползунок. |
| sliderMoved() | пользователь перетаскивает ползунок. |
| sliderReleased() | пользователь отпускает ползунок. |
| actionTriggered() | было вызвано действие ползунка. |
| rangeChanged() | изменился диапазон. |
QAbstractSlider предоставляет виртуальную функцию sliderChange(), которая хорошо подходит для обновления экранного представления ползунков. Вызывая triggerAction(), подклассы вызывают действия ползунка. Две вспомогательные функции QStyle::sliderPositionFromValue() и QStyle::sliderValueFromPosition() помогают подклассам и стилям сопоставлять координаты экрана с логическими значениями диапазона.
См. также QAbstractSpinBox, QSlider, QDial, QScrollBar и Пример с ползунками.
Документация по типам членов
перечисление QAbstractSlider::SliderAction
| Постоянная | Значение |
|---|---|
QAbstractSlider::SliderNoAction |
0 |
QAbstractSlider::SliderSingleStepAdd |
1 |
QAbstractSlider::SliderSingleStepSub |
2 |
QAbstractSlider::SliderPageStepAdd |
3 |
QAbstractSlider::SliderPageStepSub |
4 |
QAbstractSlider::SliderToMinimum |
5 |
QAbstractSlider::SliderToMaximum |
6 |
QAbstractSlider::SliderMove |
7 |
перечисление QAbstractSlider::SliderChange
| Постоянная | Значение |
|---|---|
QAbstractSlider::SliderRangeChange |
0 |
QAbstractSlider::SliderOrientationChange |
1 |
QAbstractSlider::SliderStepsChange |
2 |
QAbstractSlider::SliderValueChange |
3 |
Документация свойств
invertedAppearance : bool
Это свойство указывает, отображаются ли значения ползунка в инвертированном порядке.
Если это свойство равно false (значение по умолчанию), минимальное и максимальное значения будут отображаться в классическом положении для наследуемого виджета. Если значение равно true, минимальное и максимальное значения отображаются в противоположных положениях.
Примечание: Это свойство наиболее уместно для ползунков и регуляторов. Для полос прокрутки визуальный эффект подконтролей полосы прокрутки зависит от того, понимают ли стили инвертированное отображение; большинство стилей игнорируют это свойство для полос прокрутки.
Функции доступа:
| bool | invertedAppearance() const |
| void | setInvertedAppearance(bool) |
invertedControls : bool
Это свойство указывает, инвертирует ли ползунок события колесика мыши и клавиш.
Если это свойство равно false, прокрутка колесика мыши «вверх» и использование клавиш, таких как Page Up, будет увеличивать значение ползунка в сторону его максимального значения. В противном случае нажатие Page Up переместит значение к минимальному значению ползунка.
Функции доступа:
| bool | invertedControls() const |
| void | setInvertedControls(bool) |
maximum : int
Это свойство содержит максимальное значение ползунка.
При установке этого свойства минимальное значение корректируется при необходимости, чтобы обеспечить сохранение диапазона. Также текущее значение ползунка корректируется, чтобы оно находилось в новом диапазоне.
Функции доступа:
| int | maximum() const |
| void | setMaximum(int) |
minimum : int
Это свойство содержит минимальное значение ползунка.
При установке этого свойства максимальное значение корректируется при необходимости, чтобы обеспечить сохранение диапазона. Также текущее значение ползунка корректируется, чтобы оно находилось в новом диапазоне.
Функции доступа:
| int | minimum() const |
| void | setMinimum(int) |
orientation : Qt::Orientation
Это свойство содержит ориентацию ползунка.
Ориентация должна быть Qt::Vertical (значение по умолчанию) или Qt::Horizontal.
Функции доступа:
| Qt::Orientation | orientation() const |
| void | setOrientation(Qt::Orientation) |
pageStep : int
Это свойство содержит шаг страницы.
Более крупный из двух естественных шагов, предоставляемых абстрактным ползунком, и, как правило, соответствует нажатию пользователем клавиш PageUp или PageDown.
Функции доступа:
| int | pageStep() const |
| void | setPageStep(int) |
См. также singleStep.
singleStep : int
Это свойство содержит шаг.
Меньший из двух естественных шагов, предоставляемых абстрактным ползунком, и, как правило, соответствует нажатию пользователем клавиши со стрелкой.
Если свойство изменяется во время автоматического повторяющегося события нажатия клавиши, поведение не определено.
Функции доступа:
| int | singleStep() const |
| void | setSingleStep(int) |
См. также pageStep.
sliderDown : bool
Это свойство указывает, нажат ли ползунок.
Подклассы устанавливают это свойство, чтобы сообщить абстрактному ползунку, оказывает ли tracking какое-либо влияние.
Изменение свойства sliderDown вызывает сигналы sliderPressed() и sliderReleased()
Функции доступа:
| bool | isSliderDown() const |
| void | setSliderDown(bool) |
sliderPosition : int
Это свойство содержит текущую позицию ползунка.
Если tracking включен (значение по умолчанию), это идентично value.
Функции доступа:
| int | sliderPosition() const |
| void | setSliderPosition(int) |
Сигнал уведомления:
| void | sliderMoved(int value) |
tracking : bool
Это свойство указывает, включено ли отслеживание ползунка.
Если отслеживание включено (значение по умолчанию), ползунок излучает сигнал valueChanged() во время перетаскивания. Если отслеживание отключено, ползунок излучает сигнал valueChanged() только при отпускании ползунка.
Функции доступа:
| bool | hasTracking() const |
| void | setTracking(bool enable) |
См. также sliderDown.
value : int
Это свойство содержит текущее значение ползунка.
Ползунок принудительно устанавливает значение в пределах допустимого диапазона: minimum <= value <= maximum.
Изменение значения также изменяет sliderPosition.
Функции доступа:
| int | value() const |
| void | setValue(int) |
Сигнал уведомления:
| void | valueChanged(int value) |
Документация функций-членов
QAbstractSlider::QAbstractSlider(QWidget *parent = Q_NULLPTR)
Конструктор абстрактного ползунка.
Аргумент parent передаётся конструктору QWidget.
minimum по умолчанию равен 0, maximum — 99, singleStep — 1, pageStep — 10, а начальное значение value — 0.
QAbstractSlider::~QAbstractSlider()
Удаляет ползунок.
[signal] void QAbstractSlider::actionTriggered(int action)
Этот сигнал излучается при срабатывании действия ползунка action. Действия — SliderSingleStepAdd, SliderSingleStepSub, SliderPageStepAdd, SliderPageStepSub, SliderToMinimum, SliderToMaximum и SliderMove.
При генерации сигнала, sliderPosition был скорректирован в соответствии с действием, но значение ещё не было распространено (то есть сигнал valueChanged() ещё не был сгенерирован), и визуальное отображение ещё не было обновлено. В слотах, подключенных к этому сигналу, вы можете безопасно скорректировать любое действие, вызвав setSliderPosition() самостоятельно, основываясь как на действии, так и на значении ползунка.
См. также triggerAction().
[virtual protected] void QAbstractSlider::changeEvent(QEvent *ev)
Переопределено из QWidget::changeEvent().
[virtual protected] bool QAbstractSlider::event(QEvent *e)
Переопределено из QObject::event().
[virtual protected] void QAbstractSlider::keyPressEvent(QKeyEvent *ev)
Переопределено из QWidget::keyPressEvent().
[signal] void QAbstractSlider::rangeChanged(int min, int max)
Этот сигнал генерируется, когда диапазон ползунка изменился, где min — новое минимальное значение, а max — новое максимальное значение.
[protected] SliderAction QAbstractSlider::repeatAction() const
Возвращает текущее повторяющееся действие.
См. также setRepeatAction().
[slot] void QAbstractSlider::setRange(int min, int max)
Устанавливает минимальное значение ползунка в min и максимальное в max.
Если max меньше min, min становится единственным допустимым значением.
[protected] void QAbstractSlider::setRepeatAction(SliderAction action, int thresholdTime = 500, int repeatTime = 50)
Устанавливает действие action для повторного срабатывания с интервалом repeatTime после начальной задержки thresholdTime.
См. также triggerAction() и repeatAction().
[virtual protected] void QAbstractSlider::sliderChange(SliderChange change)
Переопределите эту виртуальную функцию для отслеживания изменений ползунка, таких как SliderRangeChange, SliderOrientationChange, SliderStepsChange или SliderValueChange. По умолчанию реализация обновляет только отображение и игнорирует параметр change.
[signal] void QAbstractSlider::sliderMoved(int value)
Этот сигнал генерируется, когда sliderDown истинно и ползунок перемещается. Это обычно происходит при перетаскивании ползунка пользователем. Значение 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.
[virtual protected] void QAbstractSlider::timerEvent(QTimerEvent *e)
Переопределено из QObject::timerEvent().
void QAbstractSlider::triggerAction(SliderAction action)
Вызывает действие ползунка action. Возможные действия: SliderSingleStepAdd, SliderSingleStepSub, SliderPageStepAdd, SliderPageStepSub, SliderToMinimum, SliderToMaximum и SliderMove.
См. также actionTriggered().
[signal] void QAbstractSlider::valueChanged(int value)
Этот сигнал генерируется, когда значение ползунка изменилось, с новым значением ползунка value в качестве аргумента.
Примечание: Сигнал уведомления для свойства value.
[virtual protected] void QAbstractSlider::wheelEvent(QWheelEvent *e)
Переопределено из QWidget::wheelEvent().
© The Qt Company Ltd
Licensed under the GNU Free Documentation License, Version 1.3.
https://doc.qt.io/qt-5.9/qabstractslider.html
