RecycleView 数据模型

在 1.10.0 版本加入.

RecycleView 模型-视图-控制器模式中的数据模型部分。

它定义了存储与 RecycleViewBehavior 相关联数据的模型(类)。每个模型(类)决定了数据如何存储,并在数据被修改时向控制器(RecycleViewBehavior)发出请求。

class kivy.uix.recycleview.datamodel.RecycleDataModel(**kwargs)[源代码]

基类:RecycleDataModelBehavior, EventDispatcher

一个实现 RecycleDataModelBehavior 的类,它将数据保存在可索引的列表中。参见 data

当数据发生变化时,该类当前会分派 on_data_changed 事件,并附带以下附加关键字参数之一。

none:无关键字参数

无附加参数时,表示通用数据变更。

removed:一个切片或整数

该值是一个切片或整数,表示被移除的索引。

appended:一个切片

data 中的切片,指示第一个和最后一个新项目(即指向末尾新增项目的切片)。

inserted:一个整数

:新数据项插入到 data 中的索引位置。

modified:一个切片

数据已被修改的索引切片。目前这不允许更改大小等。

attach_recycleview(rv)[源代码]

RecycleViewBehavior 与此数据模型关联。

data

使用列表存储模型的数据。

索引为 i 的项的数据也可以通过 RecycleDataModel [i] 访问。

detach_recycleview()[源代码]

移除与此数据模型关联的 RecycleViewBehavior

property observable_dict

一个字典实例,当其被修改时会触发 data 事件,进而触发 on_data_changed 的分发。

class kivy.uix.recycleview.datamodel.RecycleDataModelBehavior[源代码]

基类:object

RecycleDataModelBehavior 是描述并为 RecycleViewBehavior 提供数据的模型基类。

事件:
on_data_changed

当数据发生变化时触发。该事件可能会分发特定于数据模型各实现的关键字参数。触发时,事件及关键字参数会被转发至 refresh_from_data()

attach_recycleview(rv)[源代码]

RecycleViewBehavior 与此数据模型关联。

detach_recycleview()[源代码]

移除与此数据模型关联的 RecycleViewBehavior

recycleview

与此数据模型关联的 RecycleViewBehavior 实例。