javafx.stage

Class DirectoryChooser

java.lang.Object

javafx.stage.DirectoryChooser

public final class DirectoryChooser
extends java.lang.Object

Provides support for standard directory chooser dialogs. These dialogs have look and feel of the platform UI components which is independent of JavaFX. On some platforms where file access may be restricted or not part of the user model (for example, on some mobile or embedded devices), opening a directory dialog may always result in a no-op (that is, null file being returned).

Since:

JavaFX 2.1

Property Summary

Type	Property and Description
<any>	initialDirectory The initial directory for the displayed dialog.
StringProperty	title The title of the displayed dialog.

Field Summary

Fields

Modifier and Type	Field and Description
private <any>	initialDirectory The initial directory for the displayed dialog.
private StringProperty	title The title of the displayed dialog.

Constructor Summary

Constructors

Constructor and Description
DirectoryChooser()

Method Summary

Modifier and Type	Method and Description
java.io.File	getInitialDirectory() Gets the value of the property initialDirectory.
java.lang.String	getTitle() Gets the value of the property title.
<any>	initialDirectoryProperty() The initial directory for the displayed dialog.
void	setInitialDirectory(java.io.File value) Sets the value of the property initialDirectory.
void	setTitle(java.lang.String value) Sets the value of the property title.
java.io.File	showDialog(Window ownerWindow) Shows a new directory selection dialog.
StringProperty	titleProperty() The title of the displayed dialog.

Methods inherited from class java.lang.Object

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

Property Detail

title

public final StringProperty titleProperty

The title of the displayed dialog.

See Also:

getTitle(), setTitle(String)

initialDirectory

public final <any> initialDirectoryProperty

The initial directory for the displayed dialog.

See Also:

getInitialDirectory(), setInitialDirectory(File)

Field Detail

title

private StringProperty title

The title of the displayed dialog.

initialDirectory

private <any> initialDirectory

The initial directory for the displayed dialog.

Constructor Detail

DirectoryChooser

public DirectoryChooser()

Method Detail

setTitle

public final void setTitle(java.lang.String value)

Sets the value of the property title.

getTitle

public final java.lang.String getTitle()

Gets the value of the property title.

titleProperty

public final StringProperty titleProperty()

The title of the displayed dialog.

See Also:

getTitle(), setTitle(String)

setInitialDirectory

public final void setInitialDirectory(java.io.File value)

Sets the value of the property initialDirectory.

getInitialDirectory

public final java.io.File getInitialDirectory()

Gets the value of the property initialDirectory.

initialDirectoryProperty

public final <any> initialDirectoryProperty()

The initial directory for the displayed dialog.

See Also:

getInitialDirectory(), setInitialDirectory(File)

showDialog

public java.io.File showDialog(Window ownerWindow)

Shows a new directory selection dialog. The method doesn't return until the displayed dialog is dismissed. The return value specifies the directory chosen by the user or null if no selection has been made. If the owner window for the directory selection dialog is set, input to all windows in the dialog's owner chain is blocked while the dialog is being shown.

Parameters:

ownerWindow - the owner window of the displayed dialog

Returns:

the selected directory or null if no directory has been selected