虚拟列表框示例¶

此示例展示了如何创建一个列表框组件，该组件显示来自外部数据源的一组对象。在此示例中，外部数据源是一个包含图像文件名列表的文本文件。列表框显示图像及其文件名。由于图像加载速度慢且占用大量内存，显示的图像仅在用户滚动列表框时按需加载。使用 Visual Studio 构建并运行示例应用程序。

获取示例¶

要获取该示例，请在 Kanzi Studio Quick Start 窗口中点击 Examples。在 Virtual_list_box 示例旁边，点击。

Kanzi Studio 将该示例下载到 <KanziWorkspace>/Examples/Virtual_list_box 目录。

工具工程的主要组成部分包括：

预设件模板，用于指定如何显示单个图像及其标题。
指定预设实例在场景中放置位置的列表框。该列表框的 Object Generator 属性设置为字符串 CustomObjectGenerator，这意味着列表框的内容不是来自工具项目，而是来自示例应用程序代码中指定的自定义对象生成器。

应用程序代码定义了 CustomObjectGenerator，它通过读取一个文本文件来确定可用的图像文件集合。列表框向对象生成器请求所有可见对象，列表中的其余对象则是“虚拟”的。滚动列表框时，可见对象会发生变化，列表框会请求更多对象。对于每个请求的对象，对象生成器会启动一个后台任务来加载所请求的图像，实例化图像预设件，并将实例化后的对象交给列表框显示。

要运行示例：

在 Kanzi Studio 中，选择 File > Open Kanzi Command Prompt。

Kanzi Command Prompt 打开 Windows 命令提示符，并为您打开 Kanzi Command Prompt 的 Kanzi 版本设置 Kanzi 环境变量。

使用 Kanzi Command Prompt 访问 Kanzi 实用程序和构建工具，例如 Gradle、SCons 和 CMake，而无需使用绝对路径或设置环境变量。

小技巧

您可以在 Windows 开始菜单的 Rightware 目录中找到 Kanzi Command Prompt。

当您安装了多个版本的 Kanzi 时，确保将您要在该命令提示符下使用的 Kanzi 版本的 Kanzi Command Prompt 启动。
在 <KanziWorkspace>/Examples/Virtual_list_box/Application 目录中的 Kanzi Command Prompt 中运行生成示例应用程序的 Visual Studio 解决方案的脚本。

例如，如果您使用 Visual Studio 2019，运行
```
generate_cmake_vs2019_solution.bat
```
此脚本在目录 <KanziWorkspace>/Examples/Virtual_list_box/Application/build_vs2019 中为应用程序生成一个 Visual Studio 解决方案。
在 Visual Studio 中打开 <KanziWorkspace>/Examples/Virtual_list_box/Application/build_vs<Version>/Virtual_list_box.sln Visual Studio 解决方案。
在 Visual Studio 的 Solution Explorer 中，右键点击 Virtual_list_box 项目并选择 Set as StartUp Project。
选择您要使用的解决方案配置并运行您的应用程序。

在开发期间，选择 Debug 配置。当您准备好创建生产版本时，选择 Release 配置。