Класс QScrollerProperties
Класс QScrollerProperties хранит настройки для QScroller. Подробнее...
| Заголовок: | #include <QScrollerProperties> |
| qmake: | QT += widgets |
| С момента: | Qt 4.8 |
Типы публичного доступа
| перечисление | FrameRates { Fps60, Fps30, Fps20, Standard } |
| перечисление | OvershootPolicy { OvershootWhenScrollable, OvershootAlwaysOff, OvershootAlwaysOn } |
| перечисление | ScrollMetric { MousePressEventDelay, DragStartDistance, DragVelocitySmoothingFactor, AxisLockThreshold, ..., ScrollMetricCount } |
Функции публичного доступа
| QScrollerProperties() | |
| QScrollerProperties(const QScrollerProperties &sp) | |
| virtual | ~QScrollerProperties() |
| QVariant | scrollMetric(QScrollerProperties::ScrollMetric metric) const |
| void | setScrollMetric(QScrollerProperties::ScrollMetric metric, const QVariant &value) |
| bool | operator!=(const QScrollerProperties &sp) const |
| QScrollerProperties & | operator=(const QScrollerProperties &sp) |
| bool | operator==(const QScrollerProperties &sp) const |
Статические члены публичного доступа
| void | setDefaultScrollerProperties(const QScrollerProperties &sp) |
| void | unsetDefaultScrollerProperties() |
Подробное описание
Класс QScrollerProperties хранит настройки для QScroller.
Класс QScrollerProperties хранит параметры, используемые QScroller.
Значения по умолчанию зависят от платформы, чтобы Qt эмулировал поведение платформы для кинетического прокручивания.
В соответствии с соглашением, QScrollerProperties находятся в физических единицах (метр, секунда) и преобразуются QScroller с использованием текущего DPI.
См. также QScroller.
Документация по типам членов
перечисление QScrollerProperties::FrameRates
Это перечисление описывает доступные частоты кадров, используемые во время перетаскивания или прокручивания.
| Постоянная | Значение | Описание |
|---|---|---|
QScrollerProperties::Fps60 |
1 |
60 кадров в секунду |
QScrollerProperties::Fps30 |
2 |
30 кадров в секунду |
QScrollerProperties::Fps20 |
3 |
20 кадров в секунду |
QScrollerProperties::Standard |
0 |
Значение по умолчанию составляет 60 кадров в секунду (что соответствует QAbstractAnimation). |
перечисление QScrollerProperties::OvershootPolicy
Это перечисление описывает различные режимы перехода за пределы.
| Постоянная | Значение | Описание |
|---|---|---|
QScrollerProperties::OvershootWhenScrollable |
0 |
Переход за пределы возможен, когда содержимое прокручивается. Это значение по умолчанию. |
QScrollerProperties::OvershootAlwaysOff |
1 |
Переход за пределы никогда не включен, даже когда содержимое прокручивается. |
QScrollerProperties::OvershootAlwaysOn |
2 |
Переход за пределы всегда включен, даже когда содержимое не прокручивается. |
перечисление QScrollerProperties::ScrollMetric
Это перечисление содержит различные типы метрик прокрутки. Если не указано иное, функция setScrollMetric ожидает QVariant типа qreal.
См. документацию QScroller для получения дополнительной информации о концепциях, стоящих за различными значениями.
| Константа | Значение | Описание |
|---|---|---|
QScrollerProperties::MousePressEventDelay |
0 |
Это время, в течение которого событие нажатия мыши задерживается при запуске жеста flick в [s]. Если жест инициируется в течение этого времени, никакое событие нажатия или отпускания мыши не отправляется на прокручиваемый объект. Если он запускается после задержки, то задержанное событие нажатия мыши плюс поддельное событие отпускания в глобальных координатах QPoint(-QWIDGETSIZE_MAX, -QWIDGETSIZE_MAX) отправляется. Если жест отменён, то и задержанное событие нажатия, и реальное событие отпускания будут доставлены. |
QScrollerProperties::DragStartDistance |
1 |
Это минимальное расстояние, на которое необходимо переместить точку касания или указатель мыши, прежде чем будет инициирован жест flick в m. |
QScrollerProperties::DragVelocitySmoothingFactor |
2 |
Значение, описывающее степень включения новых скоростей перетаскивания в итоговую скорость прокрутки. Это значение должно быть в диапазоне от 0 до 1. Чем меньше значение, тем больше сглаживания применяется к скорости перетаскивания. |
QScrollerProperties::AxisLockThreshold |
3 |
Ограничивает движение до одной оси, если движение происходит внутри угла вокруг этой оси. Пороговое значение должно быть в диапазоне от 0 до 1. |
QScrollerProperties::ScrollingCurve |
4 |
Кривая сглаживания (QEasingCurve), используемая при замедлении скорости прокрутки после инициированного пользователем жеста flick. Обратите внимание, что это кривая сглаживания для позиций, а не для скорости: по умолчанию используется QEasingCurve::OutQuad, что приводит к линейному уменьшению скорости (первая производная) и постоянному замедлению (вторая производная). |
QScrollerProperties::DecelerationFactor |
5 |
Этот фактор влияет на то, сколько времени требуется прокручивателю, чтобы замедлиться до 0 скорости. Фактическое значение зависит от выбранной кривой прокрутки. Для большинства типов значение должно быть в диапазоне от 0.1 до 2.0 |
QScrollerProperties::MinimumVelocity |
6 |
Минимальная скорость, необходимая после завершения касания или отпускания мыши для начала прокрутки в m/s. |
QScrollerProperties::MaximumVelocity |
7 |
Это максимальная скорость, которая может быть достигнута в m/s. |
QScrollerProperties::MaximumClickThroughVelocity |
8 |
Это максимальная разрешённая скорость прокрутки для клика сквозь (click-through) в m/s. Это означает, что щелчок по объекту, который в данный момент (медленно) прокручивается, не только остановит прокрутку, но и доставит событие щелчка в элемент управления пользовательского интерфейса. Это полезно при использовании кривых прокрутки экспоненциального типа. |
QScrollerProperties::AcceleratingFlickMaximumTime |
9 |
Это максимальное время в seconds , которое может длиться жест flick, чтобы быть распознанным как ускоренный flick. Если установлено в ноль, такие жесты не обнаруживаются. "Ускоренный flick" — это жест flick, выполненный над уже прокручиваемым объектом. В таких случаях скорость прокрутки умножается на AcceleratingFlickSpeedupFactor для её ускорения. |
QScrollerProperties::AcceleratingFlickSpeedupFactor |
10 |
Текущая скорость умножается на это число, если обнаружен ускоренный flick. Должно быть >= 1. |
QScrollerProperties::SnapPositionRatio |
11 |
Это расстояние, на которое пользователь должен перетащить область между двумя точками фиксации, чтобы зафиксировать её на следующей позиции. 0.33 означает, что прокрутка должна достигнуть только одной трети расстояния между двумя точками фиксации, чтобы перейти к следующей. Коэффициент должен быть между 0 и 1. |
QScrollerProperties::SnapTime |
12 |
Этот фактор времени для кривой прокрутки. Меньшее значение означает, что прокрутка займёт больше времени. Расстояние прокрутки не зависит от этого значения. |
QScrollerProperties::OvershootDragResistanceFactor |
13 |
Это коэффициент между перетаскиванием мышью и фактическим перемещением области прокрутки (во время перескока). Коэффициент должен быть в диапазоне от 0 до 1. |
QScrollerProperties::OvershootDragDistanceFactor |
14 |
Это максимальное расстояние для движений перескока при перетаскивании. Фактическое расстояние перескока рассчитывается путём умножения этого значения на размер области просмотра прокручиваемого объекта. Коэффициент должен быть в диапазоне от 0 до 1. |
QScrollerProperties::OvershootScrollDistanceFactor |
15 |
Это максимальное расстояние для движений перескока во время прокрутки. Фактическое расстояние перескока рассчитывается путём умножения этого значения на размер области просмотра прокручиваемого объекта. Коэффициент должен быть в диапазоне от 0 до 1. |
QScrollerProperties::OvershootScrollTime |
16 |
Это время в seconds, которое используется для воспроизведения всей анимации перескока. |
QScrollerProperties::HorizontalOvershootPolicy |
17 |
Это политика горизонтального перескока (см. OvershootPolicy). |
QScrollerProperties::VerticalOvershootPolicy |
18 |
Это политика горизонтального перескока (см. OvershootPolicy). |
QScrollerProperties::FrameRate |
19 |
Это частота кадров, которая должна использоваться при перетаскивании или прокрутке. QScroller использует таймер QAbstractAnimation внутри для синхронизации всех операций прокрутки с другими анимациями, которые могут быть активны в то же время. Если стандартное значение в 60 кадров в секунду слишком быстро, его можно снизить с помощью этого параметра, оставаясь при этом синхронизированным с QAbstractAnimation. Обратите внимание, что здесь допускаются только значения перечисления FrameRates. |
QScrollerProperties::ScrollMetricCount |
20 |
Это всегда последняя запись. |
Документация функций-членов
QScrollerProperties::QScrollerProperties()
Создаёт новые свойства прокрутки.
QScrollerProperties::QScrollerProperties(const QScrollerProperties &sp)
Создаёт копию sp.
[virtual] QScrollerProperties::~QScrollerProperties()
Удаляет свойства прокрутки.
QVariant QScrollerProperties::scrollMetric(QScrollerProperties::ScrollMetric metric) const
Запрашивает значение metric свойств прокрутки.
См. также setScrollMetric() и ScrollMetric.
[static] void QScrollerProperties::setDefaultScrollerProperties(const QScrollerProperties &sp)
Устанавливает свойства прокрутки для всех новых объектов QScrollerProperties в sp.
Используйте эту функцию для переопределения свойств по умолчанию платформы, возвращаемых конструктором по умолчанию. Если вы хотите изменить свойства прокрутки только для одного прокручивателя, используйте QScroller::setScrollerProperties()
Примечание: Вызов этой функции не изменит содержимого уже существующих объектов QScrollerProperties.
См. также unsetDefaultScrollerProperties().
void QScrollerProperties::setScrollMetric(QScrollerProperties::ScrollMetric metric, const QVariant &value)
Устанавливает конкретное значение метрики metric ScrollerMetric в value.
См. также scrollMetric() и ScrollMetric.
[static] void QScrollerProperties::unsetDefaultScrollerProperties()
Возвращает свойства прокрутки, возвращаемые конструктором по умолчанию, к свойствам по умолчанию платформы.
См. также setDefaultScrollerProperties().
bool QScrollerProperties::operator!=(const QScrollerProperties &sp) const
Возвращает true, если эти свойства прокрутки отличаются от sp; в противном случае возвращает false.
QScrollerProperties &QScrollerProperties::operator=(const QScrollerProperties &sp)
Присваивает sp этим свойствам прокрутки и возвращает ссылку на эти свойства прокрутки.
bool QScrollerProperties::operator==(const QScrollerProperties &sp) const
Возвращает true , если эти свойства прокрутки равны sp; в противном случае возвращает false.
© The Qt Company Ltd
Licensed under the GNU Free Documentation License, Version 1.3.
https://doc.qt.io/archives/qt-5.11/qscrollerproperties.html
