文档



JavaFX Scene Builder:用户指南

10 FXML布局的国际化

本章介绍了JavaFX Scene Builder提供的国际化支持。

JavaFX Scene Builder工具通过使用资源束文件,使您能够将FXML布局适应不同的语言和地区。当您向内容面板添加新元素时,元素的可见属性值将设置为默认值。例如,按钮元素的默认Text属性值为Button。您可以通过将鼠标悬停在Text属性文本字段的右侧,点击出现的圆形齿轮图标,然后选择替换为国际化字符串来更改此默认值,如图10-1所示。注意,默认值将被%key.unspecified替换,您需要将其替换为在资源文件中定义的适当资源键名。百分号(%)前缀是一个可见指示器,表示其后的Text属性值是一个资源键名。您仍然可以将百分号作为Text属性值的第一个字符。如果您没有选择替换为国际化字符串设置,则在FXML文件中,百分号将显示为\%。这表示属性值的其余部分与国际化无关,也不是一个键名。

图10-1 按钮元素的国际化

图10-1的描述
"图10-1 按钮元素的国际化"的描述

HelloI18N示例可以帮助展示国际化支持。该示例包含在JavaFX Scene Builder示例包中。它的Main类展示了如何加载资源束。示例包括Bundle.properties和Bundle_fr_FR.properties文件。当您打开<javafx-scenebuilder-samples-2_0-install-dir>/HelloI18N/src/helloi18n/HelloI18N.fxml文件时,FXML文件将在自己的窗口中打开,您将看到一个标有%button.text的按钮。要本地化此标签,选择菜单栏中的预览,选择国际化设置资源,然后打开<javafx-scenebuilder-samples-2_0-install-dir>/HelloI18N/src/helloi18n Bundle.properties文件。

图10-2显示了按钮元素的Text属性值被设置为使用button.text资源键,该键在Bundle.properties文件中定义为HelloI18N的值。Text属性的文本字段前面的百分号是一个可见的指示器,表示文本字段中的值是一个资源名称。如果您替换Bundles.properties文件中分配给button.text的值并保存更改,则按钮上显示的新值会立即反映在Content面板上。您可以在资源包文件中定义其他资源键,并在您正在构建的FXML布局中使用它们。

从主菜单中选择预览,然后选择国际化命令,然后选择设置资源。在选择国际化资源文件对话框中,选择Bundle_fr_FR.properties文件,查看使用法语资源文件时HelloI18N示例应用程序的外观。注意,按钮上显示的文本现在是Bonjour。您对资源文件所做的更改并保存将反映在您在JavaFX Scene Builder工具中正在工作的FXML布局中。

图10-2 使用资源键值国际化Text属性值

图10-2的描述如下
"图10-2 使用资源键值国际化Text属性值"的描述

关闭窗口

目录

JavaFX Scene Builder: 用户指南

展开 | 折叠