Spec-Zone.ru › Qt 5.11

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

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

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 public слота унаследовано от QAbstractSlider
  • 19 public слотов унаследовано от QWidget
  • 1 public слот унаследовано от QObject
  • 6 сигналов унаследовано от QAbstractSlider
  • 3 сигнала унаследовано от QWidget
  • 2 сигнала унаследовано от QObject
  • 1 public переменная унаследована от QObject
  • 5 статических public членов унаследовано от QWidget
  • 10 статических public членов унаследовано от QObject
  • 1 защищенный слот унаследовано от QWidget
  • 2 защищенных переменных унаследовано от QObject
  • 1 защищенный тип унаследован от QPaintDevice

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

Виджет 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/archives/qt-5.11/qslider.html

Spec-Zone.ru

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