FilterAndBrowseModel QML 类型

FilterAndBrowseModel 是一种泛型模型，可用于搜索、浏览、过滤和排序数据。 更多...

• 成员列表，包括继承的成员

属性

• availableContentTypes : list<string>
• canGoBack : bool
• contentType : string
• query : string

方法

• bool canGoForward(i)
• void goBack()
• FilterAndBrowseModel goForward(i, navigationType)
• indexOf(StandardItem item)
• insert(int index, StandardItem item)
• move(int cur_index, int new_index)
• remove(int index)

详细描述

FilterAndBrowseModel 应当直接使用或作为基类，当需要在 ListView 中展示大量数据时。

该模型建立在基本的过滤和排序数据的原则之上，这些数据是在它们创建的地方进行过滤和排序的，而不是检索所有数据并在本地进行排序或过滤。另外，FilterAndBrowseModel 仅获取它真正需要的那些数据，并且可以配置如何实现这一功能。

该模型中的所有行都需要从 StandardItem 派生。

此模型中可用以下角色

设置

FilterAndBrowseModel 正在使用 QtInterfaceFramework 的 动态后端系统，并且派生自 QIfAbstractFeatureListModel。与其他大多数 "QtInterfaceFramework 功能类" 不同，FilterAndBrowseModel 不会自动连接到可用的后端。

设置它最容易的方法是连接到另一个功能使用的相同后端。例如，要连接到媒体后端，请使用 mediaplayer 功能的实例

Item {
    MediaPlayer {
        id: player
    }

    FilterAndBrowseModel {
        serviceObject: player.serviceObject
    }
}

内容类型

将模型连接到后端后，需要选择 contentType。所有可能的内容类型都可以从 availableContentTypes 属性中查询。正如其名所暗示的那样，该属性选择应显示在模型中的内容类型。对于 mediaplayer 示例，可用的内容类型可能是 "track"，"album" 和 "artist"。

过滤和排序

FilterAndBrowseModel 的主要用途之一是提供对底层数据模型内容进行过滤和排序的强大方式。如上所述，过滤和排序应在数据生成的地方进行。为了在不同后端之间使其工作，发明了 Qt 接口框架查询语言。

用于对模型内容进行排序的 query 属性，例如通过设置字符串 "[/name]"，内容将按名称升序排序。

对于过滤，使用相同的属性，但没有括号，例如 "name='Example Item'" 只显示将 'name' 属性设置为 'Example Item' 的项目。

过滤和排序也可以组合为单个字符串，并且过滤器部分也可以更复杂。更多详情可以在详细的 Qt 接口框架查询语言 文档中找到。

浏览

除了过滤和排序之外，FilterAndBrowseModel 还支持浏览不同内容类型的层次结构。解释这的最简单方法是通过查看现有的媒体示例。

在实现所有可用媒体文件的库视图时，您可能希望提供一个用户可以浏览媒体数据库并选择歌曲的方法。您可能还希望提供几个起点，并从那里限制结果。例如：

• 艺术家 -> 专辑 -> 轨道
• 专辑 -> 轨道
• 轨道

这可以通过定义一个复杂的过滤查询来实现，该查询会考虑预先选择的项目。这是最具说服力的做法，因为开发人员/设计人员可以定义浏览顺序，并且可以很容易地更改。其缺点是，后端也需要支持这种过滤和排序方式，而这并不是总是可能的。一个很好的例子是一个 DLNA 后端，其中服务器已经定义了一个固定的浏览顺序。

FilterAndBrowseModel 提供以下方法/属性进行浏览

• canGoForward()
• goForward()
• canGoBack
• goBack()

导航类型

FilterAndBrowseModel支持在浏览可用数据时两种导航类型：对于大多数用例，简单的InModelNavigation类型就足够了。通过使用它，当前模型实例的内容类型会在导航时发生变化，并且模型会重置以显示新数据。另一种导航类型是OutOfModelNavigation，它保留了当前的模型实例不变。相反，goForward()方法会返回一个包含新数据的新模型实例。这在同时需要打开多个视图时特别有用。例如，当在QML StackView中内部使用时。

StackView {
    id: stack
    initialItem: view

    Component {
        id: view
        ListView {
            model: FilterAndBrowseModel {
                contentType: "artist"
            }
            delegate: MouseArea {
                onClicked: {
                    stack.push({ "item" : view,
                                "properties:" {
                                    "model" : model->goForward(index, FilterAndBrowseModel.OutOfModelNavigation)
                                }});
                }
            }
        }
    }
}

另请参阅goForward()。

属性文档

方法文档