Spec-Zone.ru › Qt 5.6

Класс QSlider

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

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

Типы общего доступа

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

Свойства

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

Функции общего доступа

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

Переопределённые функции общего доступа

virtual bool event(QEvent *event)
virtual QSize minimumSizeHint() const
virtual QSize sizeHint() const
  • 21 функция общего доступа унаследована от QAbstractSlider
  • 211 функций общего доступа унаследовано от QWidget
  • 31 функция общего доступа унаследована от QObject
  • 14 функция общего доступа унаследована от QPaintDevice

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

void initStyleOption(QStyleOptionSlider *option) const

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

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

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

  • 3 слота общего доступа унаследовано от QAbstractSlider
  • 19 слотов общего доступа унаследовано от QWidget
  • 1 слот общего доступа унаследовано от QObject
  • 6 сигналов унаследовано от QAbstractSlider
  • 3 сигнала унаследовано от QWidget
  • 2 сигнала унаследовано от QObject
  • 5 статических членов общего доступа унаследовано от QWidget
  • 11 статических членов общего доступа унаследовано от 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 перемещает ползунок в конец (максимум).
Screenshot of a Macintosh slider Ползунок, отображаемый в стиле виджета Macintosh.
Screenshot of a Windows Vista slider Ползунок, отображаемый в стиле виджета Windows Vista.
Screenshot of a Fusion slider Ползунок, отображаемый в стиле виджета Fusion.

См. также 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.

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

TickPosition tickPosition() const
void setTickPosition(TickPosition position)

См. также tickInterval.

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

QSlider::QSlider(QWidget *parent = Q_NULLPTR)

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

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

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

QSlider::~QSlider()

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

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

Переопределяет метод QObject::event().

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

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

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

[virtual] QSize QSlider::minimumSizeHint() const

Переопределяет метод QWidget::minimumSizeHint().

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

Переопределяет метод QWidget::mouseMoveEvent().

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

Переопределяет метод QWidget::mousePressEvent().

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

Переопределяет метод QWidget::mouseReleaseEvent().

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

Переопределяет метод QWidget::paintEvent().

[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.6/qslider.html

Spec-Zone.ru

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