| gvSIG desktop 1

/* gvSIG. Sistema de Informaci?n Geogr?fica de la Generalitat Valenciana

 *

 * Copyright (C) 2004 IVER T.I. and Generalitat Valenciana.

 *

 * 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.

 *

 * For more information, contact:

 *

 *  Generalitat Valenciana

 *   Conselleria d'Infraestructures i Transport

 *   Av. Blasco Ib??ez, 50

 *   46010 VALENCIA

 *   SPAIN

 *

 *      +34 963862235

 *   gvsig@gva.es

 *      www.gvsig.gva.es

 *

 *    or

 *

 *   IVER T.I. S.A

 *   Salamanca 50

 *   46005 Valencia

 *   Spain

 *

 *   +34 963163400

 *   dac@iver.es

 */

package com.iver.andami.preferences;

import java.awt.Component;

import java.awt.GridBagConstraints;

import java.awt.GridBagLayout;

import java.awt.Insets;

import java.util.Map;

import javax.swing.JComponent;

import javax.swing.JLabel;

import javax.swing.JPanel;

import javax.swing.border.EmptyBorder;

import com.iver.utiles.extensionPoints.IExtensionBuilder;

/**

 * The abstract class that any preference page should extend.

 * 

 * @author jaume dominguez faus - jaume.dominguez

 *

 */

public abstract class AbstractPreferencePage extends JPanel implements IPreference, IExtensionBuilder{

        private GridBagLayout gridBag;

        /**

         * The number of components already added to the layout manager.

         */

        protected int y;

        private String title;

        protected String parentID = null; // Por defecto, nodo raiz

        /**

         * Creates a new preference page.

         */

        public AbstractPreferencePage()

        {

                setLayout(gridBag = new GridBagLayout());

        } 

        /**

         * Adds a labeled component to the option pane. Components are

         * added in a vertical fashion, one per row. The label is

         * displayed to the left of the component.

         * @param label The label

         * @param comp The component

         */

        public void addComponent(String label, Component comp)

        {

                JLabel l = newLabel(label, comp);

                l.setBorder(new EmptyBorder(0,0,0,12));

                addComponent(l,comp,GridBagConstraints.BOTH);

        } 

        /**

         * Adds a labeled component to the option pane. Components are

         * added in a vertical fashion, one per row. The label is

         * displayed to the left of the component.

         * @param label The label

         * @param comp The component

         * @param fill Fill parameter to GridBagConstraints for the right

         * component

         */

        public void addComponent(String label, Component comp, int fill)

        {

                JLabel l = newLabel(label, comp);

                l.setBorder(new EmptyBorder(0,0,0,12));

                addComponent(l,comp,fill);

        }

        /**

         * Adds a labeled component to the option pane. Components are

         * added in a vertical fashion, one per row. The label is

         * displayed to the left of the component.

         * @param comp1 The label

         * @param comp2 The component

         *

         * @since jEdit 4.1pre3

         */

        public void addComponent(Component comp1, Component comp2)

        {

                addComponent(comp1,comp2,GridBagConstraints.BOTH);

        }

        /**

         * Adds a labeled component to the option pane. Components are

         * added in a vertical fashion, one per row. The label is

         * displayed to the left of the component.

         * @param comp1 The label

         * @param comp2 The component

         * @param fill Fill parameter to GridBagConstraints for the right

         * component

         *

         * @since jEdit 4.1pre3

         */

        public void addComponent(Component comp1, Component comp2, int fill)

        {

                copyToolTips(comp1, comp2);

                GridBagConstraints cons = new GridBagConstraints();

                cons.gridy = y++;

                cons.gridheight = 1;

                cons.gridwidth = 1;

                cons.weightx = 0.0f;

                cons.insets = new Insets(1,0,1,0);

                cons.fill = GridBagConstraints.BOTH;

                gridBag.setConstraints(comp1,cons);

                add(comp1);

                cons.fill = fill;

                cons.gridx = 1;

                cons.weightx = 1.0f;

                gridBag.setConstraints(comp2,cons);

                add(comp2);

        }

        /**

         * Adds a component to the option pane. Components are

         * added in a vertical fashion, one per row.

         * @param comp The component

         */

        public void addComponent(Component comp)

        {

                GridBagConstraints cons = new GridBagConstraints();

                cons.gridy = y++;

                cons.gridheight = 1;

                cons.gridwidth = GridBagConstraints.REMAINDER;

                cons.fill = GridBagConstraints.NONE;

                cons.anchor = GridBagConstraints.WEST;

                cons.weightx = 1.0f;

                cons.insets = new Insets(1,0,1,0);

                gridBag.setConstraints(comp,cons);

                add(comp);

        }

        /**

         * Adds a component to the option pane. Components are

         * added in a vertical fashion, one per row.

         * @param comp The component

         * @param fill Fill parameter to GridBagConstraints

         */

        public void addComponent(Component comp, int fill)

        {

                GridBagConstraints cons = new GridBagConstraints();

                cons.gridy = y++;

                cons.gridheight = 1;

                cons.gridwidth = GridBagConstraints.REMAINDER;

                cons.fill = fill;

                cons.anchor = GridBagConstraints.WEST;

                cons.weightx = 1.0f;

                cons.insets = new Insets(1,0,1,0);

                gridBag.setConstraints(comp,cons);

                add(comp);

        } 

        private void copyToolTips (Component c1, Component c2) {

                int tooltips = 0;

                int jc=0;

                String text = null;

                JComponent jc1 = null, jc2 = null;

                try {

                        jc1 = (JComponent) c1;

                        text = jc1.getToolTipText();

                        ++jc;

                        if (text != null && text.length() > 0) tooltips++;

                }

                catch (Exception e) {}

                try {

                        jc2 = (JComponent) c2;

                        String text2 = jc2.getToolTipText();

                        ++jc;

                        if (text2 != null && text2.length() > 0) {

                                text = text2;

                                tooltips++;

                        }

                }

                catch (Exception e) {}

                if (tooltips == 1 && jc == 2) {

                        jc1.setToolTipText(text);

                        jc2.setToolTipText(text);

                }

        }

        /**

         *        @return a label which has the same tooltiptext as the Component

         *    that it is a label for. This is used to create labels from inside

         *    AbstractPreferencePage.

         */

        public JLabel newLabel(String label, Component comp) 

        {

                JLabel retval = new JLabel(label);

                try /* to get the tooltip of the component */ 

                {

                        JComponent jc = (JComponent) comp;

                        String tttext = jc.getToolTipText();

                        retval.setToolTipText(tttext);

                }

                catch (Exception e) 

                {

                        /* There probably wasn't a tooltip, 

                         * or it wasn't a JComponent.

                           We don't care. */

                }

                return retval;

        }

        public final void setParentID(String parentID) {

                this.parentID = parentID;

        }

        public final String getParentID() {

                return parentID;

        }

        public final void setTitle(String title) {

                this.title = title;

        }

        public String toString()

        {

                return title;

        }

        public Object create() {                

                return this;

        }

        public Object create(Object[] args) {

                return this;

        }

        public Object create(Map args) {

                return this;

        }

}