使用 locales¶

Kanzi 将区域设置用作 ID 来选择与语言及区域相关的资源。

如果您没有为地区定义资源，Kanzi 将使用在默认地区中设置的资源。

通过完成教程，了解如何本地化您的 Kanzi 应用程序。请参阅教程：本地化您的应用程序。

设置应用程序地区¶

在 Screen 节点中使用 Locale 属性来设置您的应用程序使用的语言环境。

例如：

要在 Kanzi Studio Preview 中使用特定的语言环境，在 Node Tree 中选择 Screen 节点，并在 Properties 中将 Locale 属性设置为您要使用的语言环境。
要设置用户启动应用程序时使用的默认语言环境，确保将 Locale 属性设置为该语言环境，并在保存 Kanzi Studio 项目并从项目中导出 kzb 文件后进行。
要使用控件设置区域设置，请使用任何触发器和 Set Property 操作来设置 Screen 节点中 Locale 属性的值。
要了解应用程序中的语言环境何时更改，请使用 On Property Change 触发器，并在 Trigger Settings 集中。

语言环境包是一个仅包含特定语言环境资源的 kzb 文件。使用 Kanzi Engine API，您可以在设置该语言环境时加载特定语言环境使用的应用程序资源。这样可以减小应用程序中 kzb 文件的大小。

当您想要将由语言包使用的资源导出到主项目 kzb 文件时，在 Library 中选择资源，并在 Properties 中添加并启用 Is Used By Code 属性。所有启用了 Is Used By Code 属性的资源仅导出到主项目 kzb 文件，而不会导出到使用它们的任何语言包中。

要创建一个地区包：

在 Library > Localization 中，将您要添加到 Kanzi 应用程序的区域设置包中使用的资源添加到本地化表中。
在 Library > Localization 中，双击任何本地化表，并在 Localization Editor 中，点击您想要导出资源到本地包的语言环境名称旁边的。
在 Kanzi Studio 中，选择 File > Export > Export KZB。此命令：
- 为您在本地化表中标记为语言环境包的每个语言环境创建一个 kzb 文件。当 Kanzi Studio 导出语言环境包时，它会根据所包含资源的语言环境命名 kzb 文件。每个语言环境包文件仅包含该语言环境使用的资源。
- 创建包含整个 Kanzi Studio 项目的主 kzb 文件，但不包括您在本地化表中标记为语言环境包的语言环境资源。
- 将语言环境包 kzb 文件存储在 <ProjectName>/Application/bin/Locale_packs 目录中，或存储在您在 Project > Properties 中指定位置的 Locale_packs 目录中，在 Binary Export Directory 属性中。
使用 Kanzi Engine API 在您的 Kanzi 应用程序中加载语言环境包。请参阅

教程：本地化您的应用程序。

Kanzi 将区域设置用作 ID 来选择与语言及区域相关的资源。

如果您没有为地区定义资源，Kanzi 将使用在默认地区中设置的资源。

当您导入 .po 文件时，Kanzi 会自动添加该 .po 文件中设置的语言环境，如果具有相同名称的语言环境尚不存在。

要手动添加地区：

在 Library > Localization 中双击任何本地化表。

Kanzi Studio 在 Localization Editor 中打开本地化表。
在 Localization Editor 中，单击 + Create Locale，输入区域设置的名称，然后单击 OK。

Kanzi Studio 将区域设置添加到项目中的所有本地化表中。

要更改现有地区的名称：