com.xmlmind.guiutil

Class ChooseURL

java.lang.Object

com.xmlmind.guiutil.ChooseURL

public final class ChooseURL
extends Object

Displays a dialog box allowing the user to specify a file or directory, open or save, URL.

An application must register its URL chooser dialog box with this facility otherwise a standard JFileChooser is used. In the latter case, the user will not be able to specify URLs other than "file:" ones.

Nested Class Summary

Nested Classes

Modifier and Type	Class and Description
static interface	ChooseURL.URLChooser This interface must be implemented by the application if it has an URL chooser dialog box.
static class	ChooseURL.URLChooserImpl Default implementation of ChooseURL.URLChooser: uses the standard JFileChooser.

Field Summary

Fields

Modifier and Type	Field and Description
static ChooseURL.URLChooserImpl	DEFAULT_CHOOSER Ready-to-use instance of ChooseURL.URLChooserImpl.

Constructor Summary

Constructors

Constructor and Description
ChooseURL()

Method Summary

Modifier and Type	Method and Description
static URL	chooseOpenDirectoryURL(Component parentComponent, URL template, ChooseFileOptions options) Convenience method: equivalent to getURLChooser().chooseOpenDirectoryURL(parentComponent, template, options).
static URL	chooseOpenFileURL(Component parentComponent, URL template, ChooseFileOptions options) Convenience method: equivalent to getURLChooser().chooseOpenFileURL(parentComponent, template, options).
static URL	chooseSaveDirectoryURL(Component parentComponent, URL template, ChooseFileOptions options) Convenience method: equivalent to getURLChooser().chooseSaveDirectoryURL(parentComponent, template, options).
static URL	chooseSaveFileURL(Component parentComponent, URL template, ChooseFileOptions options) Convenience method: equivalent to getURLChooser().chooseSaveFileURL(parentComponent, template, options).
static URL	chooseURL(Component parentComponent, URL template, boolean dirMode, boolean saveMode, ChooseFileOptions options) Selects a "file:" URL according to specified arguments.
static ChooseURL.URLChooser	getURLChooser() Returns the object implementing an URL chooser dialog box or null if such object has not been specified.
static void	setURLChooser(ChooseURL.URLChooser urlChooser) Specifies the object implementing an URL chooser dialog box.

Methods inherited from class java.lang.Object

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

Field Detail

DEFAULT_CHOOSER

public static final ChooseURL.URLChooserImpl DEFAULT_CHOOSER

Ready-to-use instance of ChooseURL.URLChooserImpl.

Constructor Detail

ChooseURL

public ChooseURL()

Method Detail

setURLChooser

public static void setURLChooser(ChooseURL.URLChooser urlChooser)

Specifies the object implementing an URL chooser dialog box.

getURLChooser

public static ChooseURL.URLChooser getURLChooser()

Returns the object implementing an URL chooser dialog box or null if such object has not been specified.

chooseOpenFileURL

public static URL chooseOpenFileURL(Component parentComponent,
                                    URL template,
                                    ChooseFileOptions options)

Convenience method: equivalent to getURLChooser().chooseOpenFileURL(parentComponent, template, options).

chooseSaveFileURL

public static URL chooseSaveFileURL(Component parentComponent,
                                    URL template,
                                    ChooseFileOptions options)

Convenience method: equivalent to getURLChooser().chooseSaveFileURL(parentComponent, template, options).

chooseOpenDirectoryURL

public static URL chooseOpenDirectoryURL(Component parentComponent,
                                         URL template,
                                         ChooseFileOptions options)

Convenience method: equivalent to getURLChooser().chooseOpenDirectoryURL(parentComponent, template, options).

chooseSaveDirectoryURL

public static URL chooseSaveDirectoryURL(Component parentComponent,
                                         URL template,
                                         ChooseFileOptions options)

Convenience method: equivalent to getURLChooser().chooseSaveDirectoryURL(parentComponent, template, options).

chooseURL

public static URL chooseURL(Component parentComponent,
                            URL template,
                            boolean dirMode,
                            boolean saveMode,
                            ChooseFileOptions options)

Selects a "file:" URL according to specified arguments. Uses standard JFileChooser for that.

Parameters:

parentComponent - used to find a parent for the dialog box

template - used as a template for URL to be selected. May be null.

dirMode - if true, selected URL must be directory

saveMode - if true, returned URL must be a save file

options - dialog box options. May be null.

Returns:

selected "file:" URL or null if user has canceled the selection.