ロケールの使用¶
Kanzi は、ロケール (Locale) を ID として使用し、言語と地域に応じたリソースを選択します。
ロケールのリソースを定義しない場合、Kanzi はデフォルトのロケールで設定されたリソースを使用します。
チュートリアルを完了して Kanzi アプリケーションをローカライズする方法を学びましょう。チュートリアル: アプリケーションをローカライズする を参照してください。
アプリケーションのロケールを設定する¶
Screen ノードで Locale プロパティを使用して、アプリケーションが使用するロケールを設定します。
例：
Kanzi Studio Preview で特定のロケールを使用するには、Node Tree で Screen ノードを選択し、Properties で Locale プロパティを使用したいロケールに設定します。
ユーザーがアプリケーションを起動したときに使用するデフォルトのロケールを設定するには、Kanzi Studio プロジェクトを保存し、プロジェクトから kzb ファイルをエクスポートした後に、Locale プロパティがそのロケールに設定されていることを確認してください。
コントロールを使用してロケールを設定するには、任意のトリガーと 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 を選択します。このコマンド：
ローカライゼーションテーブルでロケールパックとしてマークした各ロケールに対して、1つのkzbファイルを作成します。Kanzi Studio がロケールパックをエクスポートする際、kzbファイルはそのリソースを含むロケールの名前が付けられます。各ロケールパックファイルには、そのロケールで使用されるリソースのみが含まれています。
Kanzi Studio プロジェクト全体を含むメインの kzb ファイルを作成します。ただし、ローカライゼーションテーブルでロケールパックとしてマークしたロケールのリソースは除きます。
ロケールパックのkzbファイルを
<ProjectName>/Application/bin/Locale_packsディレクトリ、または Project > Properties の Binary Export Directory プロパティで指定した場所にあるLocale_packsディレクトリに保存します。
Kanzi アプリケーションでロケールパックをロードするには、Kanzi Engine API を使用します。参照
ロケールを手動で追加する¶
Kanzi は、ロケール (Locale) を ID として使用し、言語と地域に応じたリソースを選択します。
ロケールのリソースを定義しない場合、Kanzi はデフォルトのロケールで設定されたリソースを使用します。
.poファイルをインポートすると、Kanzi は、その.poファイルに設定されたロケールを自動的に追加します。同じ名前のロケールが既に存在しない場合に限ります。
ロケールを手動で追加するには:
Library > Localization で任意のローカライゼーションテーブルをダブルクリックします。
Kanzi Studio は Localization Editor でローカライゼーションテーブルを開きます。
Localization Editor で + Create Locale をクリックし、ロケールの名前を入力して、OK をクリックします。
Kanzi Studio は、プロジェクト内のすべてのローカライゼーションテーブルにロケールを追加します。
既存のロケールの名前を変更する¶
既存のロケールの名前を変更するには:
Library > Localization で任意のローカライゼーションテーブルをダブルクリックして、Localization Editor で開きます。
Localization Editor で、名前を変更したいロケールのヘッダーを右クリックし、Rename を選択します。
新しいロケールの名前を入力し、OK をクリックします。
