Spec-Zone.ru › Qt 6.1

Класс QAbstractSlider

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

Заголовок: #include <QAbstractSlider>
CMake: find_package(Qt6 COMPONENTS Widgets REQUIRED) target_link_libraries(mytarget PRIVATE Qt6::Widgets)
qmake: QT += widgets
Наследуется от: QWidget
Наследует:

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

Типы

Перечисление SliderAction { SliderNoAction, SliderSingleStepAdd, SliderSingleStepSub, SliderPageStepAdd, SliderPageStepSub, …, SliderMove }

Свойства

  • invertedAppearance : bool
  • invertedControls : bool
  • maximum : int
  • minimum : int
  • orientation : Qt::Orientation
  • pageStep : int
  • singleStep : int
  • sliderDown : bool
  • sliderPosition : int
  • tracking : bool
  • value : int

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

QAbstractSlider(QWidget *parent = nullptr)
virtual ~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(QAbstractSlider::SliderAction action)
int value() const

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

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)

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

enum SliderChange { SliderRangeChange, SliderOrientationChange, SliderStepsChange, SliderValueChange }

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

QAbstractSlider::SliderAction repeatAction() const
void setRepeatAction(QAbstractSlider::SliderAction action, int thresholdTime = 500, int repeatTime = 50)
virtual void sliderChange(QAbstractSlider::SliderChange change)

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

virtual void changeEvent(QEvent *ev) override
virtual bool event(QEvent *e) override
virtual void keyPressEvent(QKeyEvent *ev) override
virtual void timerEvent(QTimerEvent *e) override
virtual void wheelEvent(QWheelEvent *e) override

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

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

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

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

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

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

Сигнал Издаётся, когда
изменение значения() значение изменилось. Отслеживание определяет, испускается ли этот сигнал во время взаимодействия пользователя.
нажатие ползунка() пользователь начинает перетаскивать ползунок.
перемещение ползунка() пользователь перетаскивает ползунок.
отпускание ползунка() пользователь отпускает ползунок.
вызванное действие() было вызвано действие ползунка.
изменение диапазона() изменился диапазон.

QAbstractSlider предоставляет виртуальную функцию изменение ползунка(), которая хорошо подходит для обновления экранного представления ползунков. Вызывая вызвать действие(), подклассы вызывают действия ползунка. Две вспомогательные функции 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

Это свойство содержит максимальное значение ползунка.

При установке этого свойства, minimum корректируется при необходимости, чтобы обеспечить корректность диапазона. Также текущее значение ползунка корректируется, чтобы находиться в пределах нового диапазона.

Функции доступа:

int maximum() const
void setMaximum(int)

minimum : int

Это свойство содержит минимальное значение ползунка.

При установке этого свойства, maximum корректируется при необходимости, чтобы обеспечить корректность диапазона. Также текущее значение ползунка корректируется, чтобы находиться в пределах нового диапазона.

Функции доступа:

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 = nullptr)

Конструктор абстрактного ползунка.

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

minimum по умолчанию равен 0, maximum равен 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).

© The Qt Company Ltd
Licensed under the GNU Free Documentation License, Version 1.3.
https://doc.qt.io/qt-6.1/qabstractslider.html

Spec-Zone.ru

Настройки Оффлайн Что нового Помощь О нас
Spec-Zone .ru
спецификации, руководства, описания, API