org.gvsig.tools.swing.api.threadsafedialogs

Interface ThreadSafeDialogsManager

All Known Subinterfaces:

ApplicationManager, MainFrame, ThreadSafeDialogs

All Known Implementing Classes:

DefaultApplicationManager, DefaultThreadSafeDialogs, DefaultThreadSafeDialogsManager, MDIFrame

public interface ThreadSafeDialogsManager

Method Summary

Modifier and Type	Method and Description
int	confirmDialog(java.lang.String message, java.lang.String title, int optionType, int messageType) Show a JOptionPane confirm dialog.
int	confirmDialog(java.lang.String message, java.lang.String title, int optionType, int messageType, java.lang.String msgid)
java.awt.Component	createComponent(java.lang.Class<? extends java.awt.Component> theClass, java.lang.Object... parameters) Creates an return a new instance of the component specified This method ensure that the component is created in the event dispatch thread of swing.
java.awt.Component	createComponentWithParams(java.lang.Class<? extends java.awt.Component> theClass, java.lang.Object[] parameters) Creates an return a new instance of the component specified This method ensure that the component is created in the event dispatch thread of swing.
java.lang.String	inputDialog(java.lang.String message, java.lang.String title) Show a JOptionPane input dialog.
java.lang.String	inputDialog(java.lang.String message, java.lang.String title, int messageType, java.lang.String initialValue) Show a JOptionPane input dialog.
void	message(java.lang.String message, int message_type) Show a non intrusibe message to the user.
void	messageDialog(java.lang.String message, java.lang.String[] messageArgs, java.lang.String title, int messageType) Create a message dialog with ok button.
void	messageDialog(java.lang.String message, java.lang.String[] messageArgs, java.lang.String title, int messageType, java.lang.String msgid)
void	messageDialog(java.lang.String message, java.lang.String title, int messageType) Create a message dialog with an ok button.
java.io.File[]	showChooserDialog(java.lang.String title, int type, int selectionMode, boolean multiselection, java.io.File inihelpertialPath, javax.swing.filechooser.FileFilter filter, boolean fileHidingEnabled) Creates and show a JFileChooser dialog.
<any>	showChooserDialog(java.lang.String title, int type, int selectionMode, boolean multiselection, java.io.File inihelpertialPath, javax.swing.filechooser.FileFilter filter, boolean fileHidingEnabled, boolean askCharset) Creates and show a JFileChooser dialog.This method return an array whit the selected files.
java.io.File[]	showChooserDialog(java.lang.String title, int type, int selectionMode, boolean multiselection, java.io.File inihelpertialPath, javax.swing.filechooser.FileFilter filter, boolean fileHidingEnabled, javax.swing.JComponent accessory)
java.io.File[]	showOpenDirectoryDialog(java.lang.String title, java.io.File initialPath) Creates and show a JFileChooser dialog for folder selection.
java.io.File[]	showOpenFileDialog(java.lang.String title, java.io.File initialPath) Creates and show a JFileChooser dialog for selection a file for open.
java.io.File[]	showSaveFileDialog(java.lang.String title, java.io.File initialPath) Creates and show a JFileChooser dialog for selection a file for save.

Method Detail

messageDialog

void messageDialog(java.lang.String message,
                   java.lang.String title,
                   int messageType)

Create a message dialog with an ok button. If message or title start whit a "_" then try to translate. This method is thread safe to use.

Parameters:

message - to present in the dialog

title - title of the dialog

messageType - type of icon to use.

See Also:

JOptionPane.showMessageDialog(Component, Object, String, int)

messageDialog

void messageDialog(java.lang.String message,
                   java.lang.String[] messageArgs,
                   java.lang.String title,
                   int messageType)

Create a message dialog with ok button. If message or title start whit a "_" then try to translate. if messageArgs not is null the message can be formated whit MessageFormat. This method is thread safe to use.

Parameters:

message - to present in the dialog

messageArgs - string array of arguments used to format the message

title - title of the dialog

messageType - type of icon to use.

See Also:

JOptionPane.showMessageDialog(Component, Object, String, int)

messageDialog

void messageDialog(java.lang.String message,
                   java.lang.String[] messageArgs,
                   java.lang.String title,
                   int messageType,
                   java.lang.String msgid)

confirmDialog

int confirmDialog(java.lang.String message,
                  java.lang.String title,
                  int optionType,
                  int messageType)

Show a JOptionPane confirm dialog. if this method is invoked out of the event dispatch thread of swing, the dialog is presented in the thread of swing and the calling thread wait to close to continue.

Parameters:

message -

title -

optionType -

messageType -

Returns:

See Also:

JOptionPane.showConfirmDialog(Component, Object, String, int, int)

confirmDialog

int confirmDialog(java.lang.String message,
                  java.lang.String title,
                  int optionType,
                  int messageType,
                  java.lang.String msgid)

inputDialog

java.lang.String inputDialog(java.lang.String message,
                             java.lang.String title,
                             int messageType,
                             java.lang.String initialValue)

Show a JOptionPane input dialog. if this method is invoked out of the event dispatch thread of swing, the dialog is presented in the thread of swing and the calling thread wait to close to continue.

Parameters:

message -

title -

optionType - an integer designating the options available on the dialog: YES_NO_OPTION, YES_NO_CANCEL_OPTION, or OK_CANCEL_OPTION

messageType - an integer designating the kind of message this is; primarily used to determine the icon from the pluggable Look and Feel: ERROR_MESSAGE, INFORMATION_MESSAGE, WARNING_MESSAGE, QUESTION_MESSAGE, or PLAIN_MESSAGE

Returns:

See Also:

JOptionPane.showInputDialog(Component, Object, String, int)

inputDialog

java.lang.String inputDialog(java.lang.String message,
                             java.lang.String title)

Show a JOptionPane input dialog. if this method is invoked out of the event dispatch thread of swing, the dialog is presented in the thread of swing and the calling thread wait to close to continue.

Parameters:

message -

title -

optionType -

messageType -

Returns:

See Also:

JOptionPane.showInputDialog(Component, Object, String, int)

createComponent

java.awt.Component createComponent(java.lang.Class<? extends java.awt.Component> theClass,
                                   java.lang.Object... parameters)

Creates an return a new instance of the component specified This method ensure that the component is created in the event dispatch thread of swing.

Parameters:

theClass - of component to be created

parameters - passed to the constructor of the component

Returns:

the instance of the component created

createComponentWithParams

java.awt.Component createComponentWithParams(java.lang.Class<? extends java.awt.Component> theClass,
                                             java.lang.Object[] parameters)

Creates an return a new instance of the component specified This method ensure that the component is created in the event dispatch thread of swing.

Parameters:

theClass - of component to be created

parameters - passed to the constructor of the component

Returns:

the instance of the component created

showChooserDialog

java.io.File[] showChooserDialog(java.lang.String title,
                                 int type,
                                 int selectionMode,
                                 boolean multiselection,
                                 java.io.File inihelpertialPath,
                                 javax.swing.filechooser.FileFilter filter,
                                 boolean fileHidingEnabled)

Creates and show a JFileChooser dialog. This method return an array whit the selected files. If multiselection is not allowed, an array with one element is returned. If the user select the cancel button, null is returned. if this method is invoked out of the event dispatch thread of swing, the dialog is presented in the thread of swing and the calling thread wait to close to continue.

Parameters:

title, - title of dialog

type - of the dialog, JFileChooser.SAVE_DIALOG or JFileChooser.OPEN_DIALOG

selectionMode - of the dialog, values are: JFileChooser.FILES_ONLY, JFileChooser.DIRECTORIES_ONLY, JFileChooser.FILES_AND_DIRECTORIES

multiselection, - true if multiselection is allowed

inihelpertialPath, - to show in the dialog

filter - used to filter the files show in the dialog.

fileHidingEnabled, - if true hidden files are show

Returns:

an array whit the files selecteds or null.

showChooserDialog

<any> showChooserDialog(java.lang.String title,
                        int type,
                        int selectionMode,
                        boolean multiselection,
                        java.io.File inihelpertialPath,
                        javax.swing.filechooser.FileFilter filter,
                        boolean fileHidingEnabled,
                        boolean askCharset)

Creates and show a JFileChooser dialog.This method return an array whit the selected files. If multiselection is not allowed, an array with one element is returned. If the user select the cancel button, null is returned. if this method is invoked out of the event dispatch thread of swing, the dialog is presented in the thread of swing and the calling thread wait to close to continue.

Parameters:

title, - title of dialog

type - of the dialog, JFileChooser.SAVE_DIALOG or JFileChooser.OPEN_DIALOG

selectionMode - of the dialog, values are: JFileChooser.FILES_ONLY, JFileChooser.DIRECTORIES_ONLY, JFileChooser.FILES_AND_DIRECTORIES

multiselection, - true if multiselection is allowed

inihelpertialPath, - to show in the dialog

filter - used to filter the files show in the dialog.

fileHidingEnabled, - if true hidden files are show

askCharset -

Returns:

an array whit the files selecteds or null.

showChooserDialog

java.io.File[] showChooserDialog(java.lang.String title,
                                 int type,
                                 int selectionMode,
                                 boolean multiselection,
                                 java.io.File inihelpertialPath,
                                 javax.swing.filechooser.FileFilter filter,
                                 boolean fileHidingEnabled,
                                 javax.swing.JComponent accessory)

showOpenDirectoryDialog

java.io.File[] showOpenDirectoryDialog(java.lang.String title,
                                       java.io.File initialPath)

Creates and show a JFileChooser dialog for folder selection. This is an utility method that wrap a showChooserDialog call.

Parameters:

title, - title of dialog

initialPath, - to show in the dialog

Returns:

an array whit the files selecteds or null.

See Also:

showChooserDialog(String, int, int, boolean, File, FileFilter, boolean)

showOpenFileDialog

java.io.File[] showOpenFileDialog(java.lang.String title,
                                  java.io.File initialPath)

Creates and show a JFileChooser dialog for selection a file for open. This is an utility method that wrap a showChooserDialog(String, int, int, boolean, File, FileFilter, boolean) call.

Parameters:

title, - title of dialog

initialPath, - to show in the dialog

Returns:

an array whit the files selecteds or null.

See Also:

showChooserDialog(String, int, int, boolean, File, FileFilter, boolean)

showSaveFileDialog

java.io.File[] showSaveFileDialog(java.lang.String title,
                                  java.io.File initialPath)

Creates and show a JFileChooser dialog for selection a file for save. This is an utility method that wrap a showChooserDialog(String, int, int, boolean, File, FileFilter, boolean) call.

Parameters:

title, - title of dialog

initialPath, - to show in the dialog

Returns:

an array whit the files selecteds or null.

See Also:

showChooserDialog(String, int, int, boolean, File, FileFilter, boolean)

message

void message(java.lang.String message,
             int message_type)

Show a non intrusibe message to the user. This method is thread safe.

Parameters:

message -

message_type - One of: JOptionPane.ERROR_MESSAGE, JOptionPane.WARNING_MESSAGE, JOptionPane.INFORMATION_MESSAGE