当前页面: 开发资料首页 → Netbeans 专题 → 在 NetBeans IDE 中对 GUI 窗体进行国际化(1)

在 NetBeans IDE 中对 GUI 窗体进行国际化(1)

摘要: The following tutorial shows you ways how to internationalize GUI forms in NetBeansTM IDE 5.0. In the first exercise, we will use the GUI Builder's string editor to set the display text for a GUI component with an internationalized string as you design the form. The second exercise shows you how to use the Internationalization wizard to internationalize hard-coded strings in multiple files at once. The last exercise shows you how to internationalize strings in a single file and how to easily insert an internationalized string in source code while you are coding.

Expected duration: 30 minutes

Prerequisites

This tutorial assumes you have some basic knowledge of, or programming experience with, the following technologies:

NetBeans IDE

Software Needed for the Tutorial

Before you begin, you need to install the following software on your computer:

NetBeans IDE 5.0 (download)
Java Standard Development Kit (JDK^TM) version 1.4.2 (download) or 5.0 (download)

Tutorial Exercises

About Internationalization
Internationalizing a GUI Form at Design Time
Internationalizing an Entire Project
Internationalizing a Single Form
Related Topics

About Internationalization

Internationalization permits applications to be adapted to various languages and regions without requiring engineering changes or recompilation. Internationalized programs enable textual elements, such as status messages and GUI component labels, to be stored outside the source code and retrieved dynamically rather than hard-coded in the program.

You typically store your internationalized strings in properties files, in the form of key/value pairs. The key is the identifier used by the program to retrieve the text, and the value is the actual text. You create one properties file for each locale (or language) in which you translate the program. The keys are the same in each locale - only the strings are different.

The IDE provides tools for doing each of the following:

Inserting internationalized strings as you create a GUI form or Java program

Replacing all hard-coded strings in an individual file or group of files with internationalized strings

Internationalizing a GUI Form at Design Time

In this exercise we will open the demo Java application project, which contains a well-known find dialog created using GUI Builder (Matisse). Next, we will create a new properties file which will contain internationalized strings. Then, we will use GUI Builder's string editor to change a text of components to an internationalized strings. In order to test our internationalized GUI form, we will add a new locale to properties file and run the form in the non-default locale.

Opening the Example Project

Download and unzip the InternationlizeDemo.zip project to any location on your computer.

Choose File > Open Project (Ctrl-Shit-O), select the InternationalizeDemo folder you created in the last step, and click Open.

Expand Source Packages > Demo and double-click FindDialog.java. The sample form opens in the GUI Builder.

To view a demonstration of how to create this GUI form, click View Demo.

Creating a Properties File

Choose File > New File or click the New File icon in the IDE toolbar.

Select the Properties File template from the Other category and click Next.

Type Bundle in the File Name field and specify the folder src/demo location.

Click Finish.
The IDE creates the Bundle.properties file (see the Projects window) and opens the Bundle(default language) file in the Source Editor.

Internationalizing Individual GUI Components

We will now use the GUI builder to enter internationalized strings for the JLabels and JButtons in the form.

Select the appropriate GUI component (e.g. jLabel1) in the Design Area.

In the Properties window, click ellipsis (...) button for the Text property. Note that you can also internationalize other properties that have String values, such as Mnemonic, Accessible Name, Accessible Descriptor, and ToolTip.

Select Resource Bundle in the Select Mode combo box. The property editor switches to resource bundle mode.

For the Bundle Name field, click Browse to select the src/demo/Bundle.properties file.

Type Find_What: in the Key field and Find What: in the Value field.

Click OK.
Repeat the previous steps for all components so that the form looks like the following picture:

To view a demonstration of internationalizing jLabel1 , click View Demo