Spec-Zone.ru › Qt 5.6

Класс QAbstractSlider

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

Заголовок: #include <QAbstractSlider>
qmake: QT += widgets
Наследуется от: QWidget
Наследует:

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

Типы

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

Свойства

  • invertedAppearance : bool
  • invertedControls : bool
  • maximum : int
  • minimum : int
  • orientation : Qt::Orientation
  • pageStep : int
  • singleStep : int
  • sliderDown : bool
  • sliderPosition : int
  • tracking : bool
  • value : int
  • 58 свойств, унаследованных от QWidget
  • 1 свойство, унаследованное от QObject

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

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
  • 211 открытых функций, унаследованных от QWidget
  • 31 открытых функций, унаследованных от QObject
  • 14 открытых функций, унаследованных от QPaintDevice

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

void setOrientation(Qt::Orientation)
void setRange(int min, int max)
void setValue(int)
  • 19 открытых слотов, унаследованных от QWidget
  • 1 открытый слот, унаследованный от QObject

Сигналы

void actionTriggered(int action)
void rangeChanged(int min, int max)
void sliderMoved(int value)
void sliderPressed()
void sliderReleased()
void valueChanged(int value)
  • 3 сигнала, унаследованные от QWidget
  • 2 сигнала, унаследованные от QObject

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

Перечисление 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.

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

  1. value: Ограниченное целое число, которое QAbstractSlider поддерживает.
  2. minimum: Минимальное возможное значение.
  3. maximum: Максимальное возможное значение.
  4. singleStep: Меньший из двух естественных шагов, которые предоставляет абстрактный ползунок, и обычно соответствует нажатию пользователем стрелки.
  5. pageStep: Больший из двух естественных шагов, которые предоставляет абстрактный ползунок, и обычно соответствует нажатию пользователем клавиш PageUp или PageDown.
  6. tracking: Включено ли отслеживание ползунка.
  7. 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 и Пример ползунков.

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

enum 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

enum 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 — новое максимальное значение.

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

[protected] SliderAction QAbstractSlider::repeatAction() const

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

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

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

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

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

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

[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/archives/qt-5.6/qabstractslider.html

Spec-Zone.ru

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