Класс 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