Версия 2.1.0

Quick search

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() для аргументов.