org.gvsig.tools.swing.api.threadsafedialogs

Interface ThreadSafeDialogsManager

All Known Implementing Classes:

DefaultThreadSafeDialogsManager

public interface ThreadSafeDialogsManager

Method Summary

Methods

Modifier and Type	Method and Description
int	confirmDialog(String message, String title, int optionType, int messageType) Show a JOptionPane confirm dialog.
Component	createComponent(Class<? extends Component> theClass, 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.
Component	createComponentWithParams(Class<? extends Component> theClass, 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.
String	inputDialog(String message, String title) Show a JOptionPane input dialog.
String	inputDialog(String message, String title, int messageType, String initialValue) Show a JOptionPane input dialog.
void	messageDialog(String message, String[] messageArgs, String title, int messageType) Create a message dialog with ok button.
void	messageDialog(String message, String title, int messageType) Create a message dialog with an ok button.
File[]	showChooserDialog(String title, int type, int selectionMode, boolean multiselection, File inihelpertialPath, FileFilter filter, boolean fileHidingEnabled) Creates and show a JFileChooser dialog.
File[]	showOpenDirectoryDialog(String title, File initialPath) Creates and show a JFileChooser dialog for folder selection.
File[]	showOpenFileDialog(String title, File initialPath) Creates and show a JFileChooser dialog for selection a file for open.
File[]	showSaveFileDialog(String title, File initialPath) Creates and show a JFileChooser dialog for selection a file for save.

Method Detail

messageDialog

void messageDialog(String message,
                 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(String message,
                 String[] messageArgs,
                 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)

confirmDialog

int confirmDialog(String message,
                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)

inputDialog

String inputDialog(String message,
                 String title,
                 int messageType,
                 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

String inputDialog(String message,
                 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

Component createComponent(Class<? extends Component> theClass,
                        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

Component createComponentWithParams(Class<? extends Component> theClass,
                                  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

File[] showChooserDialog(String title,
                       int type,
                       int selectionMode,
                       boolean multiselection,
                       File inihelpertialPath,
                       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.

showOpenDirectoryDialog

File[] showOpenDirectoryDialog(String title,
                             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

File[] showOpenFileDialog(String title,
                        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

File[] showSaveFileDialog(String title,
                        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)