1. /* ===========================================================

  2.  * JFreeChart : a free chart library for the Java(tm) platform

  3.  * ===========================================================

  4.  *

  5.  * (C) Copyright 2000-2004, by Object Refinery Limited and Contributors.

  6.  *

  7.  * Project Info:  http://www.jfree.org/jfreechart/index.html

  8.  *

  9.  * This library is free software; you can redistribute it and/or modify it under the terms

  10.  * of the GNU Lesser General Public License as published by the Free Software Foundation;

  11.  * either version 2.1 of the License, or (at your option) any later version.

  12.  *

  13.  * This library is distributed in the hope that it will be useful, but WITHOUT ANY WARRANTY;

  14.  * without even the implied warranty of MERCHANTABILITY or FITNESS FOR A PARTICULAR PURPOSE.

  15.  * See the GNU Lesser General Public License for more details.

  16.  *

  17.  * You should have received a copy of the GNU Lesser General Public License along with this

  18.  * library; if not, write to the Free Software Foundation, Inc., 59 Temple Place, Suite 330,

  19.  * Boston, MA 02111-1307, USA.

  20.  *

  21.  * [Java is a trademark or registered trademark of Sun Microsystems, Inc. 

  22.  * in the United States and other countries.]

  23.  *

  24.  * ---------------------------

  25.  * TitlePropertyEditPanel.java

  26.  * ---------------------------

  27.  * (C) Copyright 2000-2004, by Object Refinery Limited.

  28.  *

  29.  * Original Author:  David Gilbert (for Object Refinery Limited);

  30.  * Contributor(s):   Arnaud Lelievre;

  31.  *                   Daniel Gredler;

  32.  *

  33.  * $Id: TitlePropertyEditPanel.java,v 1.4 2005/03/04 17:47:35 mungady Exp $

  34.  *

  35.  * Changes (from 24-Aug-2001)

  36.  * --------------------------

  37.  * 24-Aug-2001 : Added standard source headaer. Fixed DOS encoding problem (DG);

  38.  * 07-Nov-2001 : Separated the JCommon Class Library classes, JFreeChart now requires

  39.  *               jcommon.jar (DG);

  40.  * 31-Jan-2002 : Removed Title.java and StandardTitle.java.  Disabled some methods in this class

  41.  *               until support for AbstractTitle is added (DG);

  42.  * 20-May-2003 : Restored initialisation of titleField and titlePaint to prevent

  43.  *               NullPointer when using this class. (TM)

  44.  * 08-Sep-2003 : Added internationalization via use of properties resourceBundle (RFE 690236) (AL); 

  45.  * 08-Jan-2004 : Renamed AbstractTitle --> Title and moved to new package (DG);

  46.  * 24-Aug-2004 : Applied patch 1014378 (DG);

  47.  *

  48.  */

  49. 

  50. package org.jfree.chart.ui;

  51. 

  52. import java.awt.BorderLayout;

  53. import java.awt.Color;

  54. import java.awt.Font;

  55. import java.awt.Paint;

  56. import java.awt.event.ActionEvent;

  57. import java.awt.event.ActionListener;

  58. import java.util.ResourceBundle;

  59. 

  60. import javax.swing.BorderFactory;

  61. import javax.swing.JButton;

  62. import javax.swing.JCheckBox;

  63. import javax.swing.JColorChooser;

  64. import javax.swing.JLabel;

  65. import javax.swing.JOptionPane;

  66. import javax.swing.JPanel;

  67. import javax.swing.JTextField;

  68. 

  69. import org.jfree.chart.JFreeChart;

  70. import org.jfree.chart.title.Title;

  71. import org.jfree.chart.title.TextTitle;

  72. import org.jfree.layout.LCBLayout;

  73. import org.jfree.ui.FontChooserPanel;

  74. import org.jfree.ui.FontDisplayField;

  75. import org.jfree.ui.PaintSample;

  76. 

  77. /**

  78.  * A panel for editing the properties of a chart title.

  79.  */

  80. public class TitlePropertyEditPanel extends JPanel implements ActionListener {

  81. 

  82.     /** Whether or not to display the title on the chart. */

  83.     private boolean showTitle;

  84. 

  85.     /** The checkbox to indicate whether or not to display the title. */

  86.     private JCheckBox showTitleCheckBox;

  87. 

  88.     /** A field for displaying/editing the title text. */

  89.     private JTextField titleField;

  90. 

  91.     /** The font used to draw the title. */

  92.     private Font titleFont;

  93. 

  94.     /** A field for displaying a description of the title font. */

  95.     private JTextField fontfield;

  96. 

  97.     /** The button to use to select a new title font. */

  98.     private JButton selectFontButton;

  99. 

  100.     /** The paint (color) used to draw the title. */

  101.     private PaintSample titlePaint;

  102. 

  103.     /** The button to use to select a new paint (color) to draw the title. */

  104.     private JButton selectPaintButton;

  105. 

  106.     /** The resourceBundle for the localization. */

  107.     protected static ResourceBundle localizationResources 

  108.         = ResourceBundle.getBundle("org.jfree.chart.ui.LocalizationBundle");

  109. 

  110.     /**

  111.      * Standard constructor: builds a panel for displaying/editing the

  112.      * properties of the specified title.

  113.      *

  114.      * @param title  the title, which should be changed.

  115.      */

  116.     public TitlePropertyEditPanel(Title title) {

  117. 

  118.         TextTitle t = (title != null ? (TextTitle) title 

  119.                 : new TextTitle(localizationResources.getString("Title")));

  120.         this.showTitle = (title != null);

  121.         this.titleFont = t.getFont();

  122.         this.titleField = new JTextField(t.getText());

  123.         this.titlePaint = new PaintSample(t.getPaint());

  124. 

  125.         setLayout(new BorderLayout());

  126. 

  127.         JPanel general = new JPanel(new BorderLayout());

  128.         general.setBorder(

  129.             BorderFactory.createTitledBorder(BorderFactory.createEtchedBorder(), 

  130.             localizationResources.getString("General"))

  131.         );

  132. 

  133.         JPanel interior = new JPanel(new LCBLayout(4));

  134.         interior.setBorder(BorderFactory.createEmptyBorder(0, 5, 0, 5));

  135. 

  136.         interior.add(new JLabel(localizationResources.getString("Show_Title")));

  137.         this.showTitleCheckBox = new JCheckBox();

  138.         this.showTitleCheckBox.setSelected(this.showTitle);

  139.         this.showTitleCheckBox.setActionCommand("ShowTitle");

  140.         this.showTitleCheckBox.addActionListener(this);

  141.         interior.add(new JPanel());

  142.         interior.add(this.showTitleCheckBox);

  143. 

  144.         JLabel titleLabel = new JLabel(localizationResources.getString("Text"));

  145.         interior.add(titleLabel);

  146.         interior.add(this.titleField);

  147.         interior.add(new JPanel());

  148. 

  149.         JLabel fontLabel = new JLabel(localizationResources.getString("Font"));

  150.         this.fontfield = new FontDisplayField(this.titleFont);

  151.         this.selectFontButton = new JButton(localizationResources.getString("Select..."));

  152.         this.selectFontButton.setActionCommand("SelectFont");

  153.         this.selectFontButton.addActionListener(this);

  154.         interior.add(fontLabel);

  155.         interior.add(this.fontfield);

  156.         interior.add(this.selectFontButton);

  157. 

  158.         JLabel colorLabel = new JLabel(localizationResources.getString("Color"));

  159.         this.selectPaintButton = new JButton(localizationResources.getString("Select..."));

  160.         this.selectPaintButton.setActionCommand("SelectPaint");

  161.         this.selectPaintButton.addActionListener(this);

  162.         interior.add(colorLabel);

  163.         interior.add(this.titlePaint);

  164.         interior.add(this.selectPaintButton);

  165. 

  166.         this.enableOrDisableControls();

  167. 

  168.         general.add(interior);

  169.         add(general, BorderLayout.NORTH);

  170.     }

  171. 

  172.     /**

  173.      * Returns the title text entered in the panel.

  174.      *

  175.      * @return The title text entered in the panel.

  176.      */

  177.     public String getTitleText() {

  178.         return this.titleField.getText();

  179.     }

  180. 

  181.     /**

  182.      * Returns the font selected in the panel.

  183.      *

  184.      * @return The font selected in the panel.

  185.      */

  186.     public Font getTitleFont() {

  187.         return this.titleFont;

  188.     }

  189. 

  190.     /**

  191.      * Returns the paint selected in the panel.

  192.      *

  193.      * @return The paint selected in the panel.

  194.      */

  195.     public Paint getTitlePaint() {

  196.         return this.titlePaint.getPaint();

  197.     }

  198. 

  199.     /**

  200.      * Handles button clicks by passing control to an appropriate handler method.

  201.      *

  202.      * @param event  the event

  203.      */

  204.     public void actionPerformed(ActionEvent event) {

  205. 

  206.         String command = event.getActionCommand();

  207. 

  208.         if (command.equals("SelectFont")) {

  209.             attemptFontSelection();

  210.         }

  211.         else if (command.equals("SelectPaint")) {

  212.             attemptPaintSelection();

  213.         }

  214.         else if (command.equals("ShowTitle")) {

  215.             attemptModifyShowTitle();

  216.         }

  217.     }

  218. 

  219.     /**

  220.      * Presents a font selection dialog to the user.

  221.      */

  222.     public void attemptFontSelection() {

  223. 

  224.         FontChooserPanel panel = new FontChooserPanel(this.titleFont);

  225.         int result = 

  226.             JOptionPane.showConfirmDialog(this, panel, 

  227.                                           localizationResources.getString("Font_Selection"),

  228.                                           JOptionPane.OK_CANCEL_OPTION, JOptionPane.PLAIN_MESSAGE);

  229. 

  230.         if (result == JOptionPane.OK_OPTION) {

  231.             this.titleFont = panel.getSelectedFont();

  232.             this.fontfield.setText(this.titleFont.getFontName() + " " + this.titleFont.getSize());

  233.         }

  234.     }

  235. 

  236.     /**

  237.      * Allow the user the opportunity to select a Paint object.  For now, we

  238.      * just use the standard color chooser - all colors are Paint objects, but

  239.      * not all Paint objects are colors (later we can implement a more general

  240.      * Paint chooser).

  241.      */

  242.     public void attemptPaintSelection() {

  243.         Paint p = this.titlePaint.getPaint();

  244.         Color defaultColor = (p instanceof Color ? (Color) p : Color.blue);

  245.         Color c = JColorChooser.showDialog(

  246.             this, localizationResources.getString("Title_Color"), defaultColor

  247.         );

  248.         if (c != null) {

  249.             this.titlePaint.setPaint(c);

  250.         }

  251.     }

  252. 

  253.     /**

  254.      * Allow the user the opportunity to change whether the title is

  255.      * displayed on the chart or not.

  256.      */

  257.     private void attemptModifyShowTitle() {

  258.         this.showTitle = this.showTitleCheckBox.isSelected();

  259.         this.enableOrDisableControls();

  260.     }

  261. 

  262.     /**

  263.      * If we are supposed to show the title, the controls are enabled.

  264.      * If we are not supposed to show the title, the controls are disabled.

  265.      */

  266.     private void enableOrDisableControls() {

  267.         boolean enabled = (this.showTitle == true);

  268.         this.titleField.setEnabled(enabled);

  269.         this.selectFontButton.setEnabled(enabled);

  270.         this.selectPaintButton.setEnabled(enabled);

  271.     }

  272. 

  273.     /**

  274.      * Sets the properties of the specified title to match the properties

  275.      * defined on this panel.

  276.      *

  277.      * @param chart  the chart whose title is to be modified.

  278.      */

  279.     public void setTitleProperties(JFreeChart chart) {

  280.         if (this.showTitle) {

  281.             TextTitle title = chart.getTitle();

  282.             if (title == null) {

  283.                 title = new TextTitle();

  284.                 chart.setTitle(title);

  285.             }

  286.             title.setText(this.getTitleText());

  287.             title.setFont(this.getTitleFont());

  288.             title.setPaint(this.getTitlePaint());

  289.         }

  290.         else {

  291.             chart.setTitle((TextTitle) null);

  292.         }

  293.     }

  294. 

  295. }