Класс 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(ScrollMetric metric) const |
| void | setScrollMetric(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 |
Это время, на которое откладывается событие нажатия мыши при запуске жеста «флик» в [s]. Если жест инициирован в течение этого времени, событие нажатия или отпускания мыши не отправляется на прокручиваемый объект. Если жест инициирован после этого задержки, отправляется задержанное событие нажатия мыши плюс имитируемое событие отпускания в глобальных координатах QPoint(-QWIDGETSIZE_MAX, -QWIDGETSIZE_MAX). Если жест отменён, то оба события — задержанное нажатие и реальное отпускание — доставляются. |
QScrollerProperties::DragStartDistance |
1 |
Это минимальное расстояние, на которое должна быть перемещена точка касания или указатель мыши, прежде чем будет запущен жест «флик» в m. |
QScrollerProperties::DragVelocitySmoothingFactor |
2 |
Значение, описывающее, в какой степени новые скорости перетаскивания включаются в конечную скорость прокрутки. Это значение должно быть в диапазоне от 0 до 1. Чем меньше значение, тем больше сглаживается скорость перетаскивания. |
QScrollerProperties::AxisLockThreshold |
3 |
Ограничивает движение одной осью, если движение происходит внутри угла вокруг этой оси. Порог должен быть в диапазоне от 0 до 1. |
QScrollerProperties::ScrollingCurve |
4 |
Кривая сглаживания QEasingCurve, используемая при замедлении скорости прокрутки после инициированного пользователем жеста «флик». Обратите внимание, что это кривая сглаживания для позиций, а не для скорости: по умолчанию используется QEasingCurve::OutQuad, что приводит к линейному уменьшению скорости (первая производная) и постоянному замедлению (вторая производная). |
QScrollerProperties::DecelerationFactor |
5 |
Этот множитель влияет на то, как долго прокрутчик замедляется до скорости 0. Фактическое значение зависит от выбранной кривой прокрутки. Для большинства типов значение должно быть в диапазоне от 0.1 до 2.0 |
QScrollerProperties::MinimumVelocity |
6 |
Минимальная скорость, необходимая после завершения касания или отпускания мыши для начала прокрутки в m/s. |
QScrollerProperties::MaximumVelocity |
7 |
Это максимальная скорость, которая может быть достигнута в m/s. |
QScrollerProperties::MaximumClickThroughVelocity |
8 |
Это максимальная разрешённая скорость прокрутки для клика сквозь неё в m/s. Это означает, что клик на объекте, который в данный момент (медленно) прокручивается, не только остановит прокрутку, но и событие клика будет доставлено на элемент управления пользовательского интерфейса. Это полезно при использовании кривых прокрутки экспоненциального типа. |
QScrollerProperties::AcceleratingFlickMaximumTime |
9 |
Это максимальное время в seconds, в течение которого жест «флик» может длиться, чтобы быть распознан как ускоряющийся жест «флик». Если значение равно нулю, такой жест не обнаруживается. «Ускоряющийся флик» — это жест «флик», выполняемый на уже прокручиваемом объекте. В таких случаях скорость прокрутки умножается на множитель ускорения AcceleratingFlickSpeedupFactor для её ускорения. |
QScrollerProperties::AcceleratingFlickSpeedupFactor |
10 |
Текущая скорость умножается на это число, если обнаружен ускоряющийся флик. Должно быть >= 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(ScrollMetric metric) const
Возвращает значение метрики metric свойств прокрутки.
См. также setScrollMetric() и ScrollMetric.
[static] void QScrollerProperties::setDefaultScrollerProperties(const QScrollerProperties &sp)
Устанавливает свойства прокрутки для всех новых объектов QScrollerProperties в sp.
Используйте эту функцию для переопределения свойств платформы по умолчанию, возвращаемых конструктором по умолчанию. Если вы хотите изменить только свойства прокрутки одного прокрутчика, используйте QScroller::setScrollerProperties().
Примечание: Вызов этой функции не изменит содержимое уже существующих объектов QScrollerProperties.
См. также unsetDefaultScrollerProperties().
void QScrollerProperties::setScrollMetric(ScrollMetric metric, const QVariant &value)
Устанавливает определённое значение метрики metric ScrollMetric в 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.6/qscrollerproperties.html
