org.fuin.utils4swing.dialogs

Class DirectorySelector

java.lang.Object

org.fuin.utils4swing.dialogs.DirectorySelector

public class DirectorySelector
extends Object

Helper class for selecting a directory. Can used from a non-EDT thread.

Nested Class Summary

Nested Classes

Modifier and Type	Class and Description
static class	DirectorySelector.Result Immutable directory selection result.

Constructor Summary

Constructors

Constructor and Description
DirectorySelector(String title, String directory, boolean showIncludeSubdirs, DirectorySelectorListener listener) Constructor with title and start directory.
DirectorySelector(String title, String directory, DirectorySelectorListener listener) Constructor with title and start directory.

Method Summary

Methods

Modifier and Type	Method and Description
protected void	cancel() The user canceled the dialog.
protected void	close() Close the frame and free all resources.
static void	main(String[] args) Starts the selector for a test.
protected void	ok() The dialog was successfully finished.
static DirectorySelector.Result	selectDirectory(String title, String directory) Blocks the current thread and waits for the result of the selection dialog.
static DirectorySelector.Result	selectDirectory(String title, String directory, boolean showIncludeSubdirs) Blocks the current thread and waits for the result of the selection dialog.
void	show() Show the monitor dialog.If called outside the EDT this method will switch to the UI thread using SwingUtilities.invokeAndWait(Runnable).

Methods inherited from class java.lang.Object

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

Constructor Detail

DirectorySelector

public DirectorySelector(String title,
                 String directory,
                 DirectorySelectorListener listener)

Constructor with title and start directory. The "include sub directories" checkbox is not visible.

Parameters:

title - Title of the frame and panel.

directory - Start directory.

listener - Listener to inform about the result.

DirectorySelector

public DirectorySelector(String title,
                 String directory,
                 boolean showIncludeSubdirs,
                 DirectorySelectorListener listener)

Constructor with title and start directory.

Parameters:

title - Title of the frame and panel.

directory - Start directory.

showIncludeSubdirs - If the checkbox "include subdirectories" should be visible true else false.

listener - Listener to inform about the result.

Method Detail

show

public final void show()

Show the monitor dialog.If called outside the EDT this method will switch to the UI thread using SwingUtilities.invokeAndWait(Runnable).

close

protected final void close()

Close the frame and free all resources. After calling "close" the monitor object cannot be used again!If called outside the EDT this method will switch to the UI thread using SwingUtilities.invokeAndWait(Runnable).

cancel

protected final void cancel()

The user canceled the dialog.

ok

protected final void ok()

The dialog was successfully finished.

selectDirectory

public static DirectorySelector.Result selectDirectory(String title,
                                       String directory)
                                                throws CanceledException

Blocks the current thread and waits for the result of the selection dialog. WARNING: Don't use this inside the Event Dispatching Thread (EDT)! This is only for usage outside the UI thread. The checkbox "include subdirectories" is not visible.

Parameters:

title - Title to display for the dialog.

directory - Initial directory.

Returns:

Selection result.

Throws:

CanceledException - The user canceled the dialog.

selectDirectory

public static DirectorySelector.Result selectDirectory(String title,
                                       String directory,
                                       boolean showIncludeSubdirs)
                                                throws CanceledException

Blocks the current thread and waits for the result of the selection dialog. WARNING: Don't use this inside the Event Dispatching Thread (EDT)! This is only for usage outside the UI thread.

Parameters:

title - Title to display for the dialog.

directory - Initial directory.

showIncludeSubdirs - If the checkbox "include subdirectories" should be visible true else false.

Returns:

Selection result.

Throws:

CanceledException - The user canceled the dialog.

main

public static void main(String[] args)
                 throws IOException

Starts the selector for a test.

Parameters:

args - Not used.

Throws:

IOException - Error creating the canonical path for the current directory.