Spec-Zone.ru › Qt 5.9

Класс QSlider

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

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

Типы

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

Свойства

  • tickInterval : int
  • tickPosition : TickPosition
  • 11 свойств унаследовано от QAbstractSlider
  • 59 свойств унаследовано от 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
  • 214 открытых функций унаследовано от QWidget
  • 32 открытых функции унаследовано от 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 public slots унаследовано от QAbstractSlider
  • 19 public slots унаследовано от QWidget
  • 1 public slot унаследовано от 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 перемещает к концу (максимуму).

См. также 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/qt-5.9/qslider.html

Spec-Zone.ru

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