Класс 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 перемещает ползунок в конец (максимум).
| Ползунок, отображаемый в стиле виджета Macintosh. | |
| Ползунок, отображаемый в стиле виджета Windows Vista. | |
| Ползунок, отображаемый в стиле виджета 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