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