布局示例

此示例展示了如何使用 Kanzi Engine API 动态创建联系人列表。设置联系人项结构的布局和预设在 Kanzi Studio 项目中定义。该项目使用 Kanzi Engine API 实例化预设。使用 Visual Studio 构建并运行示例应用程序。

获取示例

要获取该示例,请在 Kanzi Studio Quick Start 窗口中点击 Examples。在 Layout 示例旁边,点击 下载。

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

示例内容

在 Kanzi Studio 项目中:

  • gridLayout 代码用于排列联系人项。

    ../../_images/layout-gridlayout.png
  • contactCard 预设件用于定义每个联系人项的结构。

    ../../_images/layout-contactcard.png

运行示例

要运行示例:

  1. 在 Kanzi Studio 中,选择 File > Open Kanzi Command Prompt。

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

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

    ../../_images/open-kanzi-command-prompt.png

    小技巧

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

    当您安装了多个版本的 Kanzi 时,确保将您要在该命令提示符下使用的 Kanzi 版本的 Kanzi Command Prompt 启动。

  2. 在 <KanziWorkspace>/Examples/Layout/Application 目录中的 Kanzi Command Prompt 中运行生成示例应用程序的 Visual Studio 解决方案的脚本。

    例如,如果您使用 Visual Studio 2019,运行

    generate_cmake_vs2019_solution.bat
    

    此脚本在目录 <KanziWorkspace>/Examples/Layout/Application/build_vs2019 中为应用程序生成一个 Visual Studio 解决方案。

  3. 在 Visual Studio 中打开 <KanziWorkspace>/Examples/Layout/Application/build_vs<Version>/Layout.sln Visual Studio 解决方案。

  4. 在 Visual Studio 的 Solution Explorer 中,右键点击 Layout 项目并选择 Set as StartUp Project。

  5. 选择您要使用的解决方案配置并运行您的应用程序。

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

    ../../_images/debug-configuration.png

另请参阅

布局控制节点

使用 Grid Layout 节点