Table Of Contents
Эффект прокрутки¶
Добавлено в версии 1.7.0.
На основе эффекта kinetic
, эффект ScrollEffect
ограничит движение в пределах, определенных его свойствами min
и max
. Если движение выходит за
эти границы, он вычислит количество overscroll
и
попытается вернуться к значению одной из границ.
Это очень полезно для реализации прокручиваемого списка. Фактически мы используем этот
класс как базовый эффект для нашего виджета ScrollView
.
- class kivy.effects.scroll.ScrollEffect(**kwargs)[исходный код]¶
Базовый класс:
kivy.effects.kinetic.KineticEffect
класс ScrollEffect. Смотрите документацию модуля для получения дополнительной информации.
- displacement¶
Накопленное расстояние движения во время взаимодействия. Это используется для определения, является ли движение перетаскиванием (больше
drag_threshold
) или нет.displacement
- этоNumericProperty
и по умолчанию равно 0.
- drag_threshold¶
Минимальное расстояние, которое нужно пройти, чтобы движение считалось перетаскиванием.
drag_threshold
- этоNumericProperty
и по умолчанию равно 20sp.
- max¶
Максимальная граница для прокрутки.
max
- этоNumericProperty
и по умолчанию равно 0.
- min¶
Минимальная граница для прокрутки.
min
- этоNumericProperty
и по умолчанию равно 0.
- overscroll¶
Вычисленное значение, когда пользователь выполняет избыточную прокрутку, то есть выходит за границы.
overscroll
- этоNumericProperty
и по умолчанию равно 0.
- reset(pos)[исходный код]¶
(внутренний) Сбросить значение и скорость до pos. Чаще всего используется при проверке границ.
- scroll¶
Вычисленное значение для прокрутки. Это значение отличается от
kivy.effects.kinetic.KineticEffect.value
тем, что оно вернется к одной из границ min/max.scroll
- этоNumericProperty
и по умолчанию равно 0.
- start(val, t=None)[исходный код]¶
Начать движение.
- Параметры
- val: float или int
Значение движения
- t: float, по умолчанию None
Время, когда произойдет движение. Если время не задано, оно будет использовать time.time()
- stop(val, t=None)[исходный код]¶
Остановить движение.
Смотрите
start()
для аргументов.
- целевой_виджет¶
Виджет, к которому привязан этот эффект. Даже если этот класс по умолчанию не вносит изменений в целевой_виджет, подклассы могут использовать его для изменения графики или применения пользовательских преобразований.
целевой_виджет
- этоObjectProperty
и по умолчанию равно None.
- update(val, t=None)[исходный код]¶
Обновить движение.
Смотрите
start()
для аргументов.