org.hortonmachine.gui.utils

Class GuiUtilities

java.lang.Object

org.hortonmachine.gui.utils.GuiUtilities

public class GuiUtilities
extends Object

Utilities class.

Author:

Andrea Antonello (www.hydrologis.com)

Nested Class Summary

Nested Classes

Modifier and Type	Class and Description
static interface	GuiUtilities.IOnCloseListener
static class	GuiUtilities.ShpFileFilter

Field Summary

Fields

Modifier and Type	Field and Description
static String	LAST_PATH
static String	PREF_STRING_SEPARATORS

Constructor Summary

Constructors

Constructor and Description
GuiUtilities()

Method Summary

Modifier and Type	Method and Description
static void	addClosingListener(JFrame frame, GuiUtilities.IOnCloseListener onCloseListener)
static void	centerOnScreen(Component component) Set the location of a component to center it on the screen.
static void	colorButton(JButton button, Color color, Integer size) Create an image to make a color picker button.
static void	copyToClipboard(String text)
static String	getFromClipboard()
static File	getLastFile() Handle the last set path preference.
static byte[]	getPreference(String preferenceKey, byte[] defaultValue)
static String	getPreference(String preferenceKey, String defaultValue) Get from preference.
static String[]	getPreference(String preferenceKey, String[] defaultValue)
static void	handleError(Component parentComponent, Exception e)
static boolean	openConfirmDialogWithPanel(Component parentComponent, JPanel panel, String title)
static JDialog	openDialogWithPanel(JPanel panel, String title, Dimension dimension, boolean modal)
static void	openDialogWithTable(String title, String[][] dataMatrix, String[] columnNames, Dimension dimension, boolean modal)
static void	openFile(File file)
static void	setDefaultLookAndFeel()
static void	setFileBrowsingOnWidgets(JTextField pathTextField, JButton browseButton, String[] allowedExtensions, Runnable postRunnable) Adds to a textfield and button the necessary to browse for a file.
static void	setFolderBrowsingOnWidgets(JTextField pathTextField, JButton browseButton) Adds to a textfield and button the necessary to browse for a folder.
static void	setLastPath(String lastPath) Save the passed path as last path available.
static void	setPreference(String preferenceKey, byte[] value)
static void	setPreference(String preferenceKey, String value) Set a preference.
static void	setPreference(String preferenceKey, String[] valuesArray)
static String	showComboDialog(Component parentComponent, String title, String message, String[] values)
static void	showErrorMessage(Component parentComponent, String message)
static void	showErrorMessage(Component parentComponent, String title, String message)
static void	showImage(Component parentComponent, String title, BufferedImage image)
static void	showInfoMessage(Component parentComponent, String message)
static void	showInfoMessage(Component parentComponent, String title, String message)
static String	showInputDialog(Component parentComponent, String message, String defaultInput)
static String[]	showMultiInputDialog(Component parentComponent, String title, String[] labels, String[] defaultValues, HashMap<String,String[]> fields2ValuesMap) Create a simple multi input pane, that returns what the use inserts.
static File[]	showOpenFilesDialog(Component parent, String title, boolean multiselection, File initialPath, FileFilter filter)
static File[]	showOpenFolderDialog(Component parent, String title, boolean multiselection, File initialPath)
static File	showSaveFileDialog(Component parent, String title, File initialPath)
static void	showWarningMessage(Component parentComponent, String message)
static void	showWarningMessage(Component parentComponent, String title, String message)
static boolean	showYesNoDialog(Component parentComponent, String message)

Methods inherited from class java.lang.Object

clone, equals, finalize, getClass, hashCode, notify, notifyAll, toString, wait, wait, wait

Field Detail

LAST_PATH

public static final String LAST_PATH

See Also:

Constant Field Values

PREF_STRING_SEPARATORS

public static final String PREF_STRING_SEPARATORS

See Also:

Constant Field Values

Constructor Detail

GuiUtilities

public GuiUtilities()

Method Detail

centerOnScreen

public static void centerOnScreen(Component component)

Set the location of a component to center it on the screen.

Parameters:

component - the component to center.

getLastFile

public static File getLastFile()

Handle the last set path preference.

Returns:

the last set path or the user home.

setLastPath

public static void setLastPath(String lastPath)

Save the passed path as last path available.

Parameters:

lastPath - the last path to save.

getPreference

public static String getPreference(String preferenceKey,
                                   String defaultValue)

Get from preference.

Parameters:

preferenceKey - the preference key.

defaultValue - the default value in case of null.

Returns:

the string preference asked.

getPreference

public static String[] getPreference(String preferenceKey,
                                     String[] defaultValue)

getPreference

public static byte[] getPreference(String preferenceKey,
                                   byte[] defaultValue)

setPreference

public static void setPreference(String preferenceKey,
                                 String value)

Set a preference.

Parameters:

preferenceKey - the preference key.

value - the value to set.

setPreference

public static void setPreference(String preferenceKey,
                                 byte[] value)

setPreference

public static void setPreference(String preferenceKey,
                                 String[] valuesArray)

copyToClipboard

public static void copyToClipboard(String text)

getFromClipboard

public static String getFromClipboard()
                               throws Exception

Throws:

Exception

openFile

public static void openFile(File file)
                     throws IOException

Throws:

IOException

openDialogWithPanel

public static JDialog openDialogWithPanel(JPanel panel,
                                          String title,
                                          Dimension dimension,
                                          boolean modal)

openDialogWithTable

public static void openDialogWithTable(String title,
                                       String[][] dataMatrix,
                                       String[] columnNames,
                                       Dimension dimension,
                                       boolean modal)

openConfirmDialogWithPanel

public static boolean openConfirmDialogWithPanel(Component parentComponent,
                                                 JPanel panel,
                                                 String title)

showInputDialog

public static String showInputDialog(Component parentComponent,
                                     String message,
                                     String defaultInput)

showYesNoDialog

public static boolean showYesNoDialog(Component parentComponent,
                                      String message)

showMultiInputDialog

public static String[] showMultiInputDialog(Component parentComponent,
                                            String title,
                                            String[] labels,
                                            String[] defaultValues,
                                            HashMap<String,String[]> fields2ValuesMap)

Create a simple multi input pane, that returns what the use inserts.

Parameters:

parentComponent -

title - the dialog title.

labels - the labels to set.

defaultValues - a set of default values.

fields2ValuesMap - a map that allows to set combos for the various options.

Returns:

the result inserted by the user.

showComboDialog

public static String showComboDialog(Component parentComponent,
                                     String title,
                                     String message,
                                     String[] values)

setDefaultLookAndFeel

public static void setDefaultLookAndFeel()

addClosingListener

public static void addClosingListener(JFrame frame,
                                      GuiUtilities.IOnCloseListener onCloseListener)

showInfoMessage

public static void showInfoMessage(Component parentComponent,
                                   String message)

showInfoMessage

public static void showInfoMessage(Component parentComponent,
                                   String title,
                                   String message)

showWarningMessage

public static void showWarningMessage(Component parentComponent,
                                      String message)

showWarningMessage

public static void showWarningMessage(Component parentComponent,
                                      String title,
                                      String message)

showErrorMessage

public static void showErrorMessage(Component parentComponent,
                                    String message)

handleError

public static void handleError(Component parentComponent,
                               Exception e)

showErrorMessage

public static void showErrorMessage(Component parentComponent,
                                    String title,
                                    String message)

showImage

public static void showImage(Component parentComponent,
                             String title,
                             BufferedImage image)

colorButton

public static void colorButton(JButton button,
                               Color color,
                               Integer size)

Create an image to make a color picker button.

Parameters:

button - the button.

color - the color to set.

size - the optional size of the image.

setFileBrowsingOnWidgets

public static void setFileBrowsingOnWidgets(JTextField pathTextField,
                                            JButton browseButton,
                                            String[] allowedExtensions,
                                            Runnable postRunnable)

Adds to a textfield and button the necessary to browse for a file.

Parameters:

pathTextField -

browseButton -

allowedExtensions -

setFolderBrowsingOnWidgets

public static void setFolderBrowsingOnWidgets(JTextField pathTextField,
                                              JButton browseButton)

Adds to a textfield and button the necessary to browse for a folder.

Parameters:

pathTextField -

browseButton -

showOpenFilesDialog

public static File[] showOpenFilesDialog(Component parent,
                                         String title,
                                         boolean multiselection,
                                         File initialPath,
                                         FileFilter filter)

showSaveFileDialog

public static File showSaveFileDialog(Component parent,
                                      String title,
                                      File initialPath)

showOpenFolderDialog

public static File[] showOpenFolderDialog(Component parent,
                                          String title,
                                          boolean multiselection,
                                          File initialPath)