跳到主要内容

OnScrollEvent

OnScrollEvent 类具有以下属性:

  • event_type(str)- 滚动事件的类型:

    • start - 控件已开始滚动;
    • update - 控件已更改其滚动位置;
    • end - 控件已停止滚动;
    • user - 用户已更改滚动方向;
    • over - 控件由于更改将导致其滚动位置超出滚动范围而未更改其滚动位置;
  • pixels(float)- 当前滚动位置,以逻辑像素表示。

  • min_scroll_extent(float)- pixels 的最小可用值范围。

  • max_scroll_extent(float)- pixels 的最大可用值范围。

  • viewport_dimension(float)- 视口的大小。

  • scroll_delta(float)- 滚动时滚动的距离,以逻辑像素表示。仅在 update 事件中设置。

  • direction(str)- 用户滚动的方向:idleforwardreverse。仅在 event_type="user" 事件中设置。

  • overscroll(float)- 滚动控件避免滚动的逻辑像素数。仅在 over 事件中设置。

  • velocity(float)- 当发生超滚时 ScrollPosition 变化的速度。仅在 over 事件中设置。