Example Four: An Improved <code>CelsiusConverter</code> (The Java™ Tutorials > Creating a GUI with JFC/Swing

« Previous • Trail • Next »

Example Four: An Improved CelsiusConverter

Topics illustrated in this example:

Adding HTML
Adding an Icon
Setting the Default Button
Creating a Formatted Text Field
Now that we've examined CelsiusConverter, let's improve it. First, we'll spiff it up by adding colored text. Next, we'll improve the button by making it the default button and adding a graphic. Finally, we'll refine the text field so that only numbers are accepted.
Adding HTML

You can specify the appearance of any Swing component's text in a couple of ways. First, you can call the setFont method to specify the font and the setColor method to set the color. Second, when you want to vary the font or color within the text or insert formatting such as line breaks, you can use HTML tags.
Buttons, labels, and many other Swing components let you use HTML to specify the format of the text displayed by the component. The following figure shows a revised temperature converter, CelsiusConverter2, which uses HTML to specify multiple text colors on the fahrenheitLabel. The code follows the figure.
To use HTML in a component's text, simply place the <HTML> tag at the beginning of the text string and then use any valid HTML code in the remainder of the string. The preceding code uses the code><font> tag to specify text color and the HTML code &#176 to display the degree symbol. More information on adding HTML to components is available in Using HTML in Swing Components.
Note: Some older releases don't support HTML text in buttons. In those that don't (such as Swing 1.1) putting HTML in a button results in an ugly-looking button whose label starts with <HTML>. You can find out when HTML support was added to each component by consulting the Version Note in Using HTML in Swing Components.

Adding an Icon
Some Swing components can be decorated with an icon — a fixed-size image. A Swing icon is an object that adheres to the Icon interface. Swing provides a particularly useful implementation of the Icon interface: ImageIcon, which paints an icon from a GIF, JPEG, or PNG image. Here's the code that adds the arrow graphic to the convertTemp button:
ImageIcon convertIcon = createImageIcon("images/convert.gif", 
                                        "Convert temperature");
...
convertTemp = new JButton(icon);
The createImageIcon method (used in the preceding snippet) is one we use in many of our code samples. The first argument specifies the file to load. The second argument provides a description of the icon that assistive technologies can use. For details, see How to Use Icons.
Setting the Default Button
Only one button in a top-level container can be the default button. The default button typically has a highlighted appearance and acts as though clicked whenever the top-level container has the keyboard focus and the user presses the Enter (or Return) key. The exact implementation depends on the look and feel.
We made the convertTemp button the default button with the following code:
//Set the button to be default button in the frame.
converterFrame.getRootPane().setDefaultButton(convertTemp);
Invoking getRootPane().setDefaultButton on a top-level container, such as converterFrame (a JFrame) makes the specified button the default for that container. You might be wondering what a root pane is. Well, every top-level container has one--it works behind the scenes to manage details such as the content pane and the menu bar. You generally don’t need to know anything more about root panes to use Swing components.
Creating a Formatted Text Field
In the original CelsiusConverter application, you could enter alphabetic or special characters in the text field. If the Convert button was pressed when the text was invalid, a NumberFormatException was thrown and the FahrenheitLabel was not updated.
CelsiusConverter2 prevents the user from entering anything but a number by replacing the JTextField with a JFormattedTextField. Formatted text fields were added in v1.4. They provide a way for developers to easily specify the legal set of characters that can be entered into a text component. In the following code, we use java.text.DecimalFormat to ensure that the text field accepts only numbers.
//Create the format for the text field and the formatted text field
tempCelsius = new JFormattedTextField(
                             new java.text.DecimalFormat("##0.0#"));
Formatted text fields are covered in depth in How to Use Formatted Text Fields.

« Previous • Trail • Next »