Класс QScrollEvent
Класс QScrollEvent отправляется при прокрутке. Подробнее...
| Заголовок: | #include <QScrollEvent> |
| CMake: | find_package(Qt6 COMPONENTS Gui REQUIRED) target_link_libraries(mytarget PRIVATE Qt6::Gui) |
| qmake: | QT += gui |
| Наследует: | QEvent |
Типы
| перечисление | ScrollState { ScrollStarted, ScrollUpdated, ScrollFinished } |
Открытые функции
| QScrollEvent(const QPointF &contentPos, const QPointF &overshootDistance, QScrollEvent::ScrollState scrollState) | |
| виртуальный | ~QScrollEvent() |
| QPointF | contentPos() const |
| QPointF | overshootDistance() const |
| QScrollEvent::ScrollState | scrollState() const |
Подробное описание
Событие прокрутки отправляется, чтобы указать получателю, что его следует прокрутить. Обычно получателем является какой-либо визуальный элемент, например, QWidget или QGraphicsObject.
Следует позаботиться о том, чтобы не отправлять конфликтующие события QScrollEvent из двух источников. Использование QScroller::scrollTo в этом случае безопасно.
См. также QScrollPrepareEvent и QScroller.
Документация по типам членов
перечисление QScrollEvent::ScrollState
Это перечисление описывает состояния, которые может иметь событие прокрутки.
| Константа | Значение | Описание |
|---|---|---|
QScrollEvent::ScrollStarted |
0 |
Устанавливается для первого события прокрутки активности прокрутки. |
QScrollEvent::ScrollUpdated |
1 |
Устанавливается для всех событий прокрутки, кроме первого и последнего, в рамках активности прокрутки. |
QScrollEvent::ScrollFinished |
2 |
Устанавливается для последнего события прокрутки активности прокрутки. |
См. также QScrollEvent::scrollState().
Документация по функциям-членам
QScrollEvent::QScrollEvent(const QPointF &contentPos, const QPointF &overshootDistance, QScrollEvent::ScrollState scrollState)
Создаёт новое событие QScrollEvent. contentPos — новая позиция содержимого, overshootDistance — новое расстояние перехвата, а scrollState указывает, является ли это событие прокрутки первым, последним или каким-то промежуточным.
[virtual] QScrollEvent::~QScrollEvent()
Уничтожает QScrollEvent.
QPointF QScrollEvent::contentPos() const
Возвращает новую позицию прокрутки.
QPointF QScrollEvent::overshootDistance() const
Возвращает новое расстояние перехвата. См. QScroller для объяснения этого термина.
См. также QScroller.
QScrollEvent::ScrollState QScrollEvent::scrollState() const
Возвращает текущее состояние прокрутки в виде комбинации значений ScrollStateFlag. ScrollStarted (или ScrollFinished) будет установлено, если это событие прокрутки является первым (или последним) событием в активности прокрутки. Обратите внимание, что оба значения могут быть установлены одновременно, если активность состоит из одного события QScrollEvent. Все остальные события прокрутки между ними будут иметь состояние, установленное на ScrollUpdated.
Например, виджет может откатить выделения при запуске и остановке прокрутки.
© The Qt Company Ltd
Licensed under the GNU Free Documentation License, Version 1.3.
https://doc.qt.io/qt-6.1/qscrollevent.html