Application: gvSIG desktop » Library: org.gvsig.tools

		if (index <= -1) {

			index = tabbedPane.indexOfTab(title);

		tabbedPane.setSelectedIndex(index);

import org.gvsig.tools.main.usability.UsabilityAction;

		frame.setPreferredSize(new Dimension(800, 600));

		return new MainAction[] { new DynObjectComponentAction(tabbedPane),

				new UsabilityAction(tabbedPane) };

/* gvSIG. Geographic Information System of the Valencian Government

*

* Copyright (C) 2007-2008 Infrastructures and Transports Department

* of the Valencian Government (CIT)

* 

* 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., 51 Franklin Street, Fifth Floor, Boston, 

* MA  02110-1301, USA.

* 

*/

/*

* AUTHORS (In addition to CIT):

* 2010 {}  {{Task}}

*/

package org.gvsig.tools.main.usability;

import java.awt.Component;

import javax.swing.BoxLayout;

import javax.swing.JButton;

import javax.swing.JComponent;

import javax.swing.JPanel;

import javax.swing.JTabbedPane;

import org.gvsig.tools.main.MainAction;

import org.gvsig.tools.swing.api.ToolsSwingLocator;

import org.gvsig.tools.swing.api.usability.UsabilitySwingManager;

/**

 * Shows the panel of usability components.

 * 

 * @author 2010- C?sar Ordi?ana - gvSIG team

 */

public class UsabilityAction extends MainAction {

	private static final long serialVersionUID = 6471916708466720365L;

	private static final UsabilitySwingManager manager = ToolsSwingLocator

			.getUsabilitySwingManager();

	/**

	 * @see MainAction#MainAction(JTabbedPane)

	 */

	public UsabilityAction(JTabbedPane tabbedPane) {

		super("Usability", tabbedPane);

		putValue(SHORT_DESCRIPTION, "Usability components");

	}

	@Override

	protected JComponent createComponent() {

		JTabbedPane tabbedPane = new JTabbedPane();

		tabbedPane.setTabPlacement(JTabbedPane.RIGHT);

		tabbedPane.addTab("JButton", createJButtonComponent());

		return tabbedPane;

	}

	@Override

	protected String getComponentTitle() {

		return "Usability";

	}

	private Component createJButtonComponent() {

		// Create the container panel

		JPanel panel = new JPanel();

		panel.setLayout(new BoxLayout(panel, BoxLayout.Y_AXIS));

		// panel.setLayout(new GridLayout(18, 1));

		// panel.setLayout(new );

		// Create buttons with different sizes

		StringBuffer text = new StringBuffer("012");

		for (int i = 4; i < 22; i++) {

			text.append(String.valueOf(i % 10));

			JButton button = manager.createJButton(text.toString());

			panel.add(button);

		}

		return panel;

	}

}

To add a new tab to the application, perform the following steps:

- Create a new class extending the MainAction class, implementing the methods:

  - createComponent(): create your demo panel

  - getComponentTitle(): return the name of the panel

- Add your new action class to the list of actions in the Main.createActions()

  method. 

import org.gvsig.tools.dataTypes.DataTypes;

import org.gvsig.tools.swing.api.ToolsSwingLocator;

import org.gvsig.tools.swing.api.dynobject.DynObjectSwingManager;

import org.gvsig.tools.swing.api.dynobject.dynfield.DynFieldComponentFactory;

import org.gvsig.tools.swing.impl.dynobject.DefaultDynObjectSwingManager;

import org.gvsig.tools.swing.impl.dynobject.dynfield.NumberFieldComponentFactory;

import org.gvsig.tools.swing.impl.usability.DefaultUsabilitySwingManager;

		ToolsSwingLocator

				.registerUsabilitySwingManager(DefaultUsabilitySwingManager.class);

		DynObjectSwingManager dsManager = ToolsSwingLocator

				.getDynObjectSwingManager();

		DynFieldComponentFactory numberFactory = new NumberFieldComponentFactory();

		dsManager.registerDynFieldComponentFactory(numberFactory,

				DataTypes.BYTE);

		dsManager

				.registerDynFieldComponentFactory(numberFactory, DataTypes.INT);

		dsManager.registerDynFieldComponentFactory(numberFactory,

				DataTypes.LONG);

		dsManager.registerDynFieldComponentFactory(numberFactory,

				DataTypes.FLOAT);

		dsManager.registerDynFieldComponentFactory(numberFactory,

				DataTypes.DOUBLE);

/* 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 org.gvsig.tools.swing.impl.usability.button;

import java.awt.Dimension;

import javax.swing.Action;

import javax.swing.Icon;

import javax.swing.JButton;

/**

 * According to the gvSIG's GUI style sheet all the buttons in the application

 * will have a normative size. No smaller than a concrete size, and big enough

 * to contain the text and avoiding the "..." characters. The button will grow

 * up in width by a set of widths defined in this style sheet, always choosing

 * the smallest width that can contain the text. If the biggest width is not

 * enought for this purpose then the button will automatically grow up to the

 * smallest necessary width to fit the text.<br>

 * <p>

 * The button resizing is based on the <b>setText(String txt)</b> method.

 * However, it is possible to use a custom size if you invoke one of

 * <b>setSize(..)</b>, <b>setBorders(...)</b> or <b>setPreferredSize(...)</b>

 * after invoking the <b>setText(...)<b> method.

 * <p>

 * This class is just a standard javax.swing.JButton that handles this issue.

 * </p>

 * 

 * @author jaume dominguez faus - jaume.dominguez@iver.es

 * 

 */

public class JStandardizedButton extends JButton {

	private static final long serialVersionUID = -1635879317292710725L;

	// TODO this should be initialized from a properties file or so.

	private static int[][] buttonSizes = new int[][] { new int[] { 90, 23 },

			new int[] { 110, 23 }, new int[] { 135, 23 }, new int[] { 160, 23 } };

	private String enableText;

	private String toolTip;

	/**

	 * Creates a new empty instance of org.gvsig.gui.beans.swing.JButton.

	 */

	public JStandardizedButton() {

		super();

	}

	/**

	 * Creates a new instance of org.gvsig.gui.beans.swing.JButton containing a

	 * text.

	 * 

	 * @param text

	 */

	public JStandardizedButton(String text) {

		super();

		setText(text);

	}

	/**

	 * Creates a new instance of org.gvsig.gui.beans.swing.JButton containing an

	 * image and a text.

	 * 

	 * @param text

	 * @param icon

	 */

	public JStandardizedButton(String text, Icon icon) {

		super(icon);

		setText(text);

	}

	/**

	 * Creates a new instance of org.gvsig.gui.beans.swing.JButton containing an

	 * image.

	 */

	public JStandardizedButton(Icon icon) {

		super(icon);

	}

	/**

	 * Creates a new instance of org.gvsig.gui.beans.swing.JButton from an

	 * {@link Action}.

	 */

	public JStandardizedButton(Action action) {

		super(action);

	}

	/**

	 * Gets the text that appears in the tooltip when the button is disabled.

	 * 

	 * @return String

	 */

	public String getEnableText() {

		return enableText;

	}

	/**

	 * Sets the text that appears in the tooltip when the button is disabled.

	 * 

	 * @param enableText

	 *            The enableText to set.

	 */

	public void setEnableText(String enableText) {

		this.enableText = enableText;

	}

	public void setEnabled(boolean aFlag) {

		super.setEnabled(aFlag);

		if (aFlag) {

			setToolTipText(toolTip);

		} else {

			setToolTipText(enableText);

		}

	}

	/**

	 * Sets the text that appears in the tooltip when the button is enabled.

	 */

	public void setToolTip(String text) {

		toolTip = text;

	}

	// public void setText(String text) {

	// super.setText(text);

	// Dimension d = getUI().getMinimumSize(this);

	// int oldWidth = (int) d.getWidth(), newWidth = oldWidth;

	// int oldHeight = (int) d.getHeight(), newHeight = oldHeight;

	//

	// // figure out the suitable width

	// for (int i = buttonSizes.length - 1; i >= 0; i--)

	// if (oldWidth < buttonSizes[i][0])

	// newWidth = buttonSizes[i][0];

	//

	// // figure out the suitable height

	// for (int i = buttonSizes.length - 1; i >= 0; i--)

	// if (oldHeight < buttonSizes[i][1])

	// newHeight = buttonSizes[i][1];

	//

	// Dimension sz = new Dimension(newWidth, newHeight);

	// super.setSize(sz);

	// super.setPreferredSize(sz);

	// }

	@Override

	public Dimension getPreferredSize() {

		Dimension d = getUI().getMinimumSize(this);

		int oldWidth = (int) d.getWidth(), newWidth = oldWidth;

		int oldHeight = (int) d.getHeight(), newHeight = oldHeight;

		// figure out the suitable width

		for (int i = buttonSizes.length - 1; i >= 0; i--)

			if (oldWidth < buttonSizes[i][0])

				newWidth = buttonSizes[i][0];

		// figure out the suitable height

		for (int i = buttonSizes.length - 1; i >= 0; i--)

			if (oldHeight < buttonSizes[i][1])

				newHeight = buttonSizes[i][1];

		return new Dimension(newWidth, newHeight);

	}

	@Override

	public Dimension getMaximumSize() {

		return getPreferredSize();

	}

	@Override

	public Dimension getMinimumSize() {

		return getPreferredSize();

	}

}

/* gvSIG. Geographic Information System of the Valencian Government

*

* Copyright (C) 2007-2008 Infrastructures and Transports Department

* of the Valencian Government (CIT)

* 

* 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., 51 Franklin Street, Fifth Floor, Boston, 

* MA  02110-1301, USA.

* 

*/

/*

* AUTHORS (In addition to CIT):

* 2010 {}  {{Task}}

*/

package org.gvsig.tools.swing.impl.usability;

import javax.swing.Action;

import javax.swing.Icon;

import javax.swing.JButton;

import org.gvsig.tools.swing.api.usability.UsabilitySwingManager;

import org.gvsig.tools.swing.impl.usability.button.JStandardizedButton;

/**

 * Default implementation for the {@link UsabilitySwingManager}.

 * 

 * @author 2010- C?sar Ordi?ana - gvSIG team

 */

public class DefaultUsabilitySwingManager implements UsabilitySwingManager {

	public JButton createJButton() {

		return new JStandardizedButton();

	}

	public JButton createJButton(String text) {

		return new JStandardizedButton(text);

	}

	public JButton createJButton(Icon icon) {

		return new JStandardizedButton(icon);

	}

	public JButton createJButton(String text, Icon icon) {

		return new JStandardizedButton(text, icon);

	}

	public JButton createJButton(Action action) {

		return new JStandardizedButton(action);

	}

}

/* gvSIG. Geographic Information System of the Valencian Government

 *

 * Copyright (C) 2007-2008 Infrastructures and Transports Department

 * of the Valencian Government (CIT)

 * 

 * 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., 51 Franklin Street, Fifth Floor, Boston, 

 * MA  02110-1301, USA.

 * 

 */

/*

 * AUTHORS (In addition to CIT):

 * 2010 {}  {{Task}}

 */

package org.gvsig.tools.swing.api.usability;

import javax.swing.Action;

import javax.swing.Icon;

import javax.swing.JButton;

/**

 * Creates common Swing components which take into account usability guides

 * defined for the gvSIG project.

 * 

 * @author 2010- C?sar Ordi?ana - gvSIG team

 */

public interface UsabilitySwingManager {

	/**

	 * Creates a button with no set text or icon.

	 * 

	 * @return a button

	 */

	JButton createJButton();

	/**

	 * Creates a button with text.

	 * 

	 * @param text

	 *            the text of the button

	 * 

	 * @return a button

	 */

	JButton createJButton(String text);

	/**

	 * Creates a button with an icon.

	 * 

	 * @param icon

	 *            the Icon image to display on the button

	 * 

	 * @return a button

	 */

	JButton createJButton(Icon icon);

	/**

	 * Creates a button with initial text and icon.

	 * 

	 * @param text

	 *            the text of the button

	 * @param icon

	 *            the Icon image to display on the button

	 * 

	 * @return a button

	 */

	JButton createJButton(String text, Icon icon);

	/**

	 * Creates a button where properties are taken from the {@link Action}

	 * supplied.

	 * 

	 * @param a

	 *            the {@link Action} used to specify the new button

	 * 

	 */

	JButton createJButton(Action action);

}

import org.gvsig.tools.swing.api.usability.UsabilitySwingManager;

	public static final String USABILITY_SWING_MANAGER_NAME = "Tools.usability.swing.manager";

	public static final String USABILITY_SWING_MANAGER_DESCRIPTION = "Tools Usability Swing Manager";

	/**

	 * Registers the Class implementing the UsabilitySwingManager interface.

	 * 

	 * @param clazz

	 *            implementing the UsabilitySwingManager interface

	 */

	public static void registerUsabilitySwingManager(

			Class<? extends UsabilitySwingManager> clazz) {

		getInstance().register(USABILITY_SWING_MANAGER_NAME,

				USABILITY_SWING_MANAGER_DESCRIPTION, clazz);

	}

	/**

	 * Gets the instance of the {@link UsabilitySwingManager} registered.

	 * 

	 * @return {@link UsabilitySwingManager}

	 */

	public static UsabilitySwingManager getUsabilitySwingManager() {

		return (UsabilitySwingManager) getInstance().get(

				USABILITY_SWING_MANAGER_NAME);

	}

import org.gvsig.tools.swing.api.usability.UsabilitySwingManager;

		DynObjectSwingManager dynObjectSwingManager = ToolsSwingLocator

				.getDynObjectSwingManager();

		if (dynObjectSwingManager == null) {

					ToolsSwingLocator.DYNOBJECT_SWING_MANAGER_NAME,

					ToolsSwingLocator.getInstance());

		// Validate there is any UsabilitySwingManager implementation

		// registered.

		UsabilitySwingManager usabilitySwingManager = ToolsSwingLocator

				.getUsabilitySwingManager();

		if (usabilitySwingManager == null) {

			throw new ReferenceNotRegisteredException(

					ToolsSwingLocator.USABILITY_SWING_MANAGER_NAME,

					ToolsSwingLocator.getInstance());

		}