Package 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	Description
static interface	GuiUtilities.IOnCloseListener
static class	GuiUtilities.ShpFileFilter

Constructor Summary

Constructors

Constructor	Description
GuiUtilities()

Method Summary

Modifier and Type	Method	Description
static void	addClosingListener(JFrame frame, GuiUtilities.IOnCloseListener onCloseListener)
static void	addFileDropTarget(Component component, Consumer<File[]> filesConsumer)
static void	applyComponentOrientation(Component component, ComponentOrientation co)
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 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	setDefaultFrameIcon(JFrame frame)	Set the default frame icon, also considering the macos case.
static void	setDefaultFrameIcon(JFrame frame, Image forceIcon)	Set the frame icon, also considering the macos case.
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, Runnable postRunnable)	Adds to a textfield and button the necessary to browse for a folder.
static void	setUIFont(FontUIResource f)
static String	showComboDialog(Component parentComponent, String title, String message, String[] values, String selectedValue)
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	showInputAreaDialog(Component parentComponent, String message, String defaultInput)
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

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.

applyComponentOrientation

public static void applyComponentOrientation(Component component,
                                             ComponentOrientation co)

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)

showInputAreaDialog

public static String showInputAreaDialog(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,
                                     String selectedValue)

setDefaultLookAndFeel

public static void setDefaultLookAndFeel()

setUIFont

public static void setUIFont(FontUIResource f)

setDefaultFrameIcon

public static void setDefaultFrameIcon(JFrame frame)

Set the default frame icon, also considering the macos case.

Parameters:

frame - the frame to set the icon for.

setDefaultFrameIcon

public static void setDefaultFrameIcon(JFrame frame,
                                       Image forceIcon)

Set the frame icon, also considering the macos case.

Parameters:

frame - the frame to set the icon for.

forceIcon - an icon to set. If null, the default icon is used.

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,
                                              Runnable postRunnable)

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)

addFileDropTarget

public static void addFileDropTarget(Component component,
                                     Consumer<File[]> filesConsumer)

Parameters:

component -

filesConsumer -