Spec-Zone.ru › Qt 5.12

Класс QSlider

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

Заголовок: #include <QSlider>
qmake: QT += widgets
Наследует: QAbstractSlider
  • Список всех членов, включая унаследованные
  • Устаревшие члены

Открытые типы

Перечисление TickPosition { НетРисок, РискиСОбеихСторон, РискиСверху, РискиСнизу, РискиСлева, РискиСправа }

Свойства

  • tickInterval : int
  • tickPosition : TickPosition
  • 11 свойств унаследовано от QAbstractSlider
  • 59 свойств унаследовано от QWidget
  • 1 свойство унаследовано от QObject

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

QSlider(QWidget *parent = nullptr)
QSlider(Qt::Orientation orientation, QWidget *parent = nullptr)
virtual ~QSlider()
void setTickInterval(int ti)
void setTickPosition(QSlider::TickPosition position)
int tickInterval() const
QSlider::TickPosition tickPosition() const

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

virtual bool event(QEvent *event) override
virtual QSize minimumSizeHint() const override
virtual QSize sizeHint() const override
  • 21 открытая функция унаследована от QAbstractSlider
  • 214 открытых функций унаследовано от QWidget
  • 31 открытая функция унаследована от QObject
  • 14 открытых функций унаследовано от QPaintDevice

Статические открытые члены

const QMetaObject staticMetaObject
  • 5 статических открытых членов унаследовано от QWidget
  • 9 статических открытых членов унаследовано от QObject

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

void initStyleOption(QStyleOptionSlider *option) const

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

virtual void mouseMoveEvent(QMouseEvent *ev) override
virtual void mousePressEvent(QMouseEvent *ev) override
virtual void mouseReleaseEvent(QMouseEvent *ev) override
virtual void paintEvent(QPaintEvent *ev) override
  • 8 защищенных функций унаследовано от QAbstractSlider
  • 35 защищенных функций унаследовано от QWidget
  • 9 защищенных функций унаследовано от QObject
  • 1 защищенная функция унаследована от QPaintDevice

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

  • 3 открытых слота унаследовано от QAbstractSlider
  • 19 открытых слотов унаследовано от QWidget
  • 1 открытый слот унаследовано от QObject
  • 6 сигналов унаследовано от QAbstractSlider
  • 3 сигнала унаследовано от QWidget
  • 2 сигнала унаследовано от QObject
  • 1 защищенный слот унаследовано от QWidget

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

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

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

QSlider имеет очень мало собственных функций; большая часть функциональности находится в QAbstractSlider. Наиболее полезными функциями являются setValue() для непосредственного задания значения ползунка, triggerAction() для имитации нажатия (полезно для сочетаний клавиш), setSingleStep(), setPageStep() для задания шагов и setMinimum() и setMaximum() для определения диапазона ползунка.

QSlider предоставляет методы для управления отметками. Вы можете использовать setTickPosition() для указания, где вы хотите разместить отметки, и setTickInterval() для указания их количества. Текущее положение и интервал отметок можно запросить с помощью функций tickPosition() и tickInterval() соответственно.

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

Сигнал Описание
valueChanged() Выдаётся, когда значение ползунка изменилось. Флаг tracking() определяет, излучается ли этот сигнал во время взаимодействия пользователя.
sliderPressed() Выдаётся, когда пользователь начинает перетаскивать ползунок.
sliderMoved() Выдаётся, когда пользователь перетаскивает ползунок.
sliderReleased() Выдаётся, когда пользователь отпускает ползунок.

QSlider поддерживает только целочисленные диапазоны. Обратите внимание, что, хотя QSlider обрабатывает очень большие числа, пользователю становится сложно точно использовать ползунок для очень больших диапазонов.

Ползунок получает фокус при нажатии Tab и поддерживает взаимодействие как с колесом мыши, так и с клавиатурой. Интерфейс клавиатуры следующий:

  • Стрелки влево/вправо перемещают горизонтальный ползунок на один шаг.
  • Стрелки вверх/вниз перемещают вертикальный ползунок на один шаг.
  • PageUp перемещает ползунок вверх на одну страницу.
  • PageDown перемещает ползунок вниз на одну страницу.
  • Home перемещает ползунок в начало (минимум).
  • End перемещает ползунок в конец (максимум).

См. также QScrollBar, QSpinBox, QDial, Руководство по проектированию пользовательского интерфейса: Ползунки и Пример ползунков.

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

Перечисление QSlider::TickPosition

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

Константа Значение Описание
QSlider::NoTicks 0 Не рисовать отметки.
QSlider::TicksBothSides 3 Рисовать отметки по обе стороны желобка.
QSlider::TicksAbove 1 Рисовать отметки над (горизонтальным) ползунком.
QSlider::TicksBelow 2 Рисовать отметки под (горизонтальным) ползунком.
QSlider::TicksLeft TicksAbove Рисовать отметки слева от (вертикального) ползунка.
QSlider::TicksRight TicksBelow Рисовать отметки справа от (вертикального) ползунка.

Документация свойств

tickInterval : int

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

Это интервал значений, а не интервал пикселей. Если он равен 0, ползунок выберет значение между singleStep и pageStep.

Значение по умолчанию — 0.

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

int tickInterval() const
void setTickInterval(int ti)

См. также tickPosition, singleStep и pageStep.

tickPosition : TickPosition

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

Допустимые значения описаны в перечислении QSlider::TickPosition.

Значение по умолчанию — QSlider::NoTicks.

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

QSlider::TickPosition tickPosition() const
void setTickPosition(QSlider::TickPosition position)

См. также tickInterval.

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

QSlider::QSlider(QWidget *parent = nullptr)

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

QSlider::QSlider(Qt::Orientation orientation, QWidget *parent = nullptr)

Создаёт ползунок с заданным parent. Параметр orientation определяет, является ли ползунок горизонтальным или вертикальным; допустимые значения — Qt::Vertical и Qt::Horizontal.

[virtual] QSlider::~QSlider()

Уничтожает этот ползунок.

[override virtual] bool QSlider::event(QEvent *event)

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

[protected] void QSlider::initStyleOption(QStyleOptionSlider *option) const

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

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

[override virtual] QSize QSlider::minimumSizeHint() const

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

[override virtual protected] void QSlider::mouseMoveEvent(QMouseEvent *ev)

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

[override virtual protected] void QSlider::mousePressEvent(QMouseEvent *ev)

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

[override virtual protected] void QSlider::mouseReleaseEvent(QMouseEvent *ev)

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

[override virtual protected] void QSlider::paintEvent(QPaintEvent *ev)

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

[override virtual] QSize QSlider::sizeHint() const

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

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

Spec-Zone.ru

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