multisteppane.java

编辑视频文件

/*
 * File:     MultiStepPane.java
 * Project:  MPI Linguistic Application
 * Date:     02 May 2007
 *
 * Copyright (C) 2001-2007  Max Planck Institute for Psycholinguistics
 *
 * This program is free software; you can redistribute it and/or modify
 * it under the terms of the GNU General Public License as published by
 * the Free Software Foundation; either version 2 of the License, or
 * (at your option) any later version.
 *
 * This program is distributed in the hope that it will be useful,
 * but WITHOUT ANY WARRANTY; without even the implied warranty of
 * MERCHANTABILITY or FITNESS FOR A PARTICULAR PURPOSE.  See the
 * GNU General Public License for more details.
 *
 * You should have received a copy of the GNU General Public License
 * along with this program; if not, write to the Free Software
 * Foundation, Inc., 59 Temple Place, Suite 330, Boston, MA  02111-1307  USA
 */

package mpi.eudico.client.annotator.gui.multistep;

import mpi.eudico.client.annotator.gui.ClosableDialog;

import java.awt.CardLayout;
import java.awt.Color;
import java.awt.Component;
import java.awt.Dimension;
import java.awt.Frame;
import java.awt.GridBagConstraints;
import java.awt.GridBagLayout;
import java.awt.GridLayout;
import java.awt.Insets;
import java.awt.event.ActionEvent;
import java.awt.event.ActionListener;

import java.util.HashMap;
import java.util.Iterator;
import java.util.ResourceBundle;
import java.util.Set;

import javax.swing.Icon;
import javax.swing.JButton;
import javax.swing.JComponent;
import javax.swing.JDialog;
import javax.swing.JPanel;
import javax.swing.WindowConstants;
import javax.swing.border.CompoundBorder;
import javax.swing.border.EmptyBorder;
import javax.swing.border.MatteBorder;


/**
 * The main panel holding ui elements of a multiple step process.
 * Uses a CardLayout to manage a number of subpanels each representing one
 * of the steps in the process.
 *
 * @author Han Sloetjes
 */
public class MultiStepPane extends JComponent implements MultiStepControl,
    ActionListener {
    /** Constant for a 'help' button */
    public static final int HELP_BUTTON = 0;

    /** Constant for the 'next' button */
    public static final int NEXT_BUTTON = 1;

    /** Constant for the 'previous' button */
    public static final int PREVIOUS_BUTTON = 2;

    /** Constant for the 'finish' button */
    public static final int FINISH_BUTTON = 3;

    /** Constant for the 'cancel' button */
    public static final int CANCEL_BUTTON = 4;

    /** Constant for all buttons */
    public static final int ALL_BUTTONS = 8;
    private ResourceBundle bundle;
    private JButton helpButton;
    private JButton nextButton;
    private JButton prevButton;
    private JButton finishButton;
    private JButton cancelButton;

    /** Constant for the prreferred panel dimension */
    private final Dimension prefSize = new Dimension(500, 400);

    /** Constant for the preferred height of the top panel or
     * the title panel */
    private final int prefTitlePanelHeight = 70;

    /** Constant for the preferred height of the control buttons panel */
    private final int prefButtonPanelHeight = 60;
    private Insets insets;
    private StepTitlePanel titlePanel;
    private JPanel stepContainer;
    private CardLayout stepLayout;
    private JPanel buttonPanel;
    private JDialog dialog;
    private HashMap stepMap;
    private HashMap stepProperties;
    private int currentStepIndex = 0;
    private StepPane currentStep;

    /**
     * Creates a new MultiStepPane instance.
     */
    public MultiStepPane() {
        initComponents();
    }

    /**
     * Creates a new MultiStepPane instance, taking strings from the resource
     * bundle for labels and buttons etc.
     *
     * @param bundle a resource bundle holding (localized) string for ui elements
     */
    public MultiStepPane(ResourceBundle bundle) {
        this.bundle = bundle;
        initComponents();
    }

    /**
     * Initializes the panel and its components.
     */
    protected void initComponents() {
        stepMap = new HashMap();
        stepProperties = new HashMap();
        setLayout(new GridBagLayout());
        setPreferredSize(prefSize);
        setMinimumSize(prefSize);
        insets = new Insets(0, 0, 0, 0);
        titlePanel = new StepTitlePanel();
        titlePanel.setPreferredSize(new Dimension(getPreferredSize().width,
                prefTitlePanelHeight));
        titlePanel.setMinimumSize(new Dimension(getPreferredSize().width,
                prefTitlePanelHeight));
        titlePanel.setBackground(Color.white);
        titlePanel.setBorder(new MatteBorder(0, 0, 1, 0, Color.DARK_GRAY));

        GridBagConstraints gridBagConstraints = new GridBagConstraints();
        gridBagConstraints.gridx = 0;
        gridBagConstraints.gridy = 0;
        gridBagConstraints.fill = GridBagConstraints.HORIZONTAL;
        gridBagConstraints.insets = insets;
        gridBagConstraints.weightx = 1.0;
        add(titlePanel, gridBagConstraints);

        stepLayout = new CardLayout();
        stepContainer = new JPanel(stepLayout);
        stepContainer.setPreferredSize(prefSize);
        gridBagConstraints = new GridBagConstraints();
        gridBagConstraints.gridx = 0;
        gridBagConstraints.gridy = 1;
        gridBagConstraints.fill = GridBagConstraints.BOTH;
        gridBagConstraints.insets = insets;
        gridBagConstraints.weightx = 1.0;
        gridBagConstraints.weighty = 1.0;

        add(stepContainer, gridBagConstraints);

        buttonPanel = new JPanel(new GridBagLayout());
        buttonPanel.setBorder(new CompoundBorder(
                new MatteBorder(1, 0, 0, 0, Color.DARK_GRAY),
                new EmptyBorder(6, 6, 6, 6)));
        helpButton = new JButton();
        nextButton = new JButton();
        prevButton = new JButton();
        finishButton = new JButton();
        cancelButton = new JButton();
        helpButton.addActionListener(this);
        nextButton.addActionListener(this);
        prevButton.addActionListener(this);
        finishButton.addActionListener(this);
        cancelButton.addActionListener(this);

        Insets buttonInsets = new Insets(4, 4, 4, 4);

        gridBagConstraints = new GridBagConstraints();
        gridBagConstraints.gridx = 0;
        gridBagConstraints.gridy = 0;
        gridBagConstraints.anchor = GridBagConstraints.WEST;
        gridBagConstraints.fill = GridBagConstraints.NONE;
        gridBagConstraints.insets = buttonInsets;
        buttonPanel.add(helpButton, gridBagConstraints);

        gridBagConstraints = new GridBagConstraints();
        gridBagConstraints.gridx = 1;
        gridBagConstraints.gridy = 0;
        gridBagConstraints.anchor = GridBagConstraints.WEST;
        gridBagConstraints.fill = GridBagConstraints.HORIZONTAL;
        gridBagConstraints.insets = buttonInsets;
        gridBagConstraints.weightx = 1.0;
        buttonPanel.add(new JPanel(), gridBagConstraints);

        JPanel buttonGroupPanel = new JPanel(new GridLayout(1, 4,
                    buttonInsets.left, buttonInsets.top));
        buttonGroupPanel.add(prevButton);
        buttonGroupPanel.add(nextButton);
        buttonGroupPanel.add(finishButton);
        buttonGroupPanel.add(cancelButton);

        gridBagConstraints = new GridBagConstraints();
        gridBagConstraints.gridx = 2;
        gridBagConstraints.gridy = 0;
        gridBagConstraints.anchor = GridBagConstraints.EAST;
        gridBagConstraints.fill = GridBagConstraints.NONE;
        gridBagConstraints.insets = buttonInsets;
        buttonPanel.add(buttonGroupPanel, gridBagConstraints);

        gridBagConstraints = new GridBagConstraints();
        gridBagConstraints.gridx = 0;
        gridBagConstraints.gridy = 2;
        gridBagConstraints.fill = GridBagConstraints.HORIZONTAL;
        gridBagConstraints.insets = insets;
        gridBagConstraints.weightx = 1.0;
        add(buttonPanel, gridBagConstraints);

        helpButton.setEnabled(false);
        helpButton.setVisible(false);
        prevButton.setEnabled(false);
        nextButton.setEnabled(false);
        finishButton.setEnabled(false);

        updateLocale();
    }

    /**
     * Applies localized strings from a bundle or uses default values if no
     * bundle is specified.
     */
    public void updateLocale() {
        if (bundle != null) {
            helpButton.setText(bundle.getString("MultiStep.Help"));
            prevButton.setText(bundle.getString("MultiStep.Previous"));
            nextButton.setText(bundle.getString("MultiStep.Next"));
            finishButton.setText(bundle.getString("MultiStep.Finish"));
            cancelButton.setText(bundle.getString("MultiStep.Cancel"));
        } else {
            helpButton.setText("Help");
            prevButton.setText("Previous");
            nextButton.setText("Next");
            finishButton.setText("Finish");
            cancelButton.setText("Cancel");
        }
    }

    /**
     * Adds a step panel to the end of the list of panels.
     *
     * @param step the step panel to add
     */
    public void addStep(StepPane step) {
        if (step == null) {
            return; // NullPointerException?
        }

        int curSize = stepMap.size();
        stepContainer.add(step, "" + curSize);
        stepMap.put(new Integer(curSize), step);

        if (curSize == 0) {
            currentStepIndex = 0;
            currentStep = step;
            stepLayout.show(stepContainer, "" + currentStepIndex);

            if (titlePanel != null) {
                titlePanel.setTitleText(currentStep.getStepTitle());
            }

            currentStep.enterStepForward();
        }
    }

    /**
     * Called when the "Next" button is clicked. Brings the next step panel
     * to front in the cardlayout.
     */
    public void nextStep() {
        if (currentStepIndex < (stepMap.size() - 1)) {
            if (currentStep.leaveStepForward()) {
                stepLayout.next(stepContainer);
                currentStepIndex++;

                prevButton.setEnabled(true);
                nextButton.setEnabled(false);
                currentStep = (StepPane) stepMap.get(new Integer(
                            currentStepIndex));

                if (titlePanel != null) {
                    titlePanel.setTitleText(currentStep.getStepTitle());
                }

                currentStep.enterStepForward();
            }
        } else if (currentStepIndex == stepMap.size()) {
            finish();
        }
    }

    /**
     * Called when the "Previous" button is clicked. Brings the previous step panel
     * to front in the cardlayout.
     */
    public void previousStep() {
        if ((currentStepIndex > 0) && (stepMap.size() > 0)) {
            if (currentStep.leaveStepBackward()) {
                stepLayout.previous(stepContainer);
                currentStepIndex--;

                if (currentStepIndex == 0) {
                    prevButton.setEnabled(false);
                }

                nextButton.setEnabled(false);
                currentStep = (StepPane) stepMap.get(new Integer(
                            currentStepIndex));

                if (titlePanel != null) {
                    titlePanel.setTitleText(currentStep.getStepTitle());
                }

                currentStep.enterStepBackward();
            }
        }
    }

    /**
     * Called when the "Finish" button has been clicked. Invokes the doFinish method on
     * the current step panel. The current Step returns true when the action of that step
     * has successfully been performed.It returns false when an error occurred or when a
     * process is still going on (and the step wants to monitor it). In that case the step
     * should explicitely call the close() method of this class.
     * By default the finished() method on all steps will then be invoked, allowing each
     * step to clean up.
     *
     * @see Step#doFinish()
     */
    public void finish() {
        if (currentStep.doFinish()) {
            // notify all steps that the process has finished
            finishNotify();

            if (dialog != null) {
                dialog.setVisible(false);
                dialog.hide();
            }
        }
    }

    /**
     * Called when the "Cancel" button has been clicked.
     * @see mpi.eudico.client.tool.viewer.enhanced.multistep.MultiStepControl#cancel()
     */
    public void cancel() {
        // notify all steps that the process has been canceled / finished
        finishNotify();

        if (dialog != null) {
            dialog.setVisible(false);
            dialog.hide();
        }
    }

    /**
     * Can be called by any step to close the dialog (if any).
     * When the last step has monitored the process (and doFinish() returned false) the
     * step can call this method at the end of the process.
     */
    public void close() {
        cancel();
    }

    /**
     * Called when the "Help" button has been clicked. Invokes showHelp on the current
     * step. It is up to the step to show some kind of help or to ignore the call.
     *
     * @see mpi.eudico.client.tool.viewer.enhanced.multistep.MultiStepControl#showHelp()
     */
    public void showHelp() {
        currentStep.showHelp();
    }

    /**
     * Adds a key-value pair to the list of properties.
     *
     * @param key the key
     * @param value the value
     * @see mpi.eudico.client.tool.viewer.enhanced.multistep.MultiStepControl#putStepProperty(java.lang.String, java.lang.Object)
     */
    public void putStepProperty(Object key, Object value) {
        stepProperties.put(key, value);
    }

    /**
     * Returns the value to which the key is mapped.
     *
     * @param key the key
     * @return the associated value
     */
    public Object getStepProperty(Object key) {
        return stepProperties.get(key);
    }

    /**
     * Returns a keyset of the properties map.
     *
     * @return a keyset of the properties map
     * @see mpi.eudico.client.tool.viewer.enhanced.multistep.MultiStepControl#getPropertyKeys()
     */
    public Set getPropertyKeys() {