org.gnu.gtk

Class FileSelection

public class FileSelection extends Dialog

Deprecated: This class is part of the java-gnome 2.x family of libraries, which, due to their inefficiency and complexity, are no longer being maintained and have been abandoned by the java-gnome project. This class may in the future have an equivalent in java-gnome 4.0, try looking for org.gnome.gtk.FileSelection. You should be aware that there is a considerably different API in the new library: the architecture is completely different and most notably internals are no longer exposed to public view.

The FileSelection widget lists all the files and directories in the current working directory and enables the user to select one of the file names. There are a number of navigation controls that enable the user to browse through the entire file system. There also are buttons that create directories, delete files, and rename files.
Constructor Summary
FileSelection(String title)
construct a new FileSelection dialog.
FileSelection(Handle handle)
Construct a FileSelection using a handle to a native resource.
Method Summary
voidcomplete(String pattern)
Will attempt to match pattern to a valid filename or subdirectory in the current directory.
ButtongetCancelButton()
Return the Cancel Button widget for this dialog.
WidgetgetDirList()
Return the directory list for this widget
WidgetgetFileList()
Returns the the file list for this widget
StringgetFilename()
Returns the selected filename.
static FileSelectiongetFileSelection(Handle handle)
Internal static factory method to be used by Java-Gnome only.
ButtongetHelpButton()
Return the Help Button widget for this dialog.
ButtongetOKButton()
Return the OK Button widget for this Dialog.
WidgetgetSelectionEntry()
Returns the selection entry
String[]getSelections()
Retrieves the list of file selections the user has made in the dialog box.
booleangetSelectMultiple()
Determines whether or not the user is allowed to select multiple files in the file list.
static TypegetType()
Retrieve the runtime type used by the GLib library.
voidhideFileopButtons()
Hides the file operation buttons that normally appear at the top of the dialog.
voidsetFilename(String filename)
Sets the default path for the file requestor.
voidsetSelectMultiple(boolean selectMultiple)
Sets whether the user is allowed to select multiple files in the file list.
voidshowFileopButtons()
Shows the file operation buttons, if they have previously been hidden.

Constructor Detail

FileSelection

public FileSelection(String title)

Deprecated: Superceeded by java-gnome 4.0; a method along these lines may well exist in the new bindings, but if it does it likely has a different name or signature due to the shift to an algorithmic mapping of the underlying native libraries.

construct a new FileSelection dialog.

Parameters: title The string that is displayed in the title bar of the dialog.

FileSelection

public FileSelection(Handle handle)

Deprecated: Superceeded by java-gnome 4.0; a method along these lines may well exist in the new bindings, but if it does it likely has a different name or signature due to the shift to an algorithmic mapping of the underlying native libraries.

Construct a FileSelection using a handle to a native resource.

Method Detail

complete

public void complete(String pattern)

Deprecated: Superceeded by java-gnome 4.0; a method along these lines may well exist in the new bindings, but if it does it likely has a different name or signature due to the shift to an algorithmic mapping of the underlying native libraries.

Will attempt to match pattern to a valid filename or subdirectory in the current directory. If a match can be made the matched filename will appear in the text entry field in the file selection dialog. If a partial match can be made the "Files" list will contain those file names which have been partially matched and the "Directories" list will list those directories which have been partially matched.

Parameters: pattern The pattern to use for matching.

getCancelButton

public Button getCancelButton()

Deprecated: Superceeded by java-gnome 4.0; a method along these lines may well exist in the new bindings, but if it does it likely has a different name or signature due to the shift to an algorithmic mapping of the underlying native libraries.

Return the Cancel Button widget for this dialog.

Returns: The Cancel Button.

getDirList

public Widget getDirList()

Deprecated: Superceeded by java-gnome 4.0; a method along these lines may well exist in the new bindings, but if it does it likely has a different name or signature due to the shift to an algorithmic mapping of the underlying native libraries.

Return the directory list for this widget

Returns: The Directory List

getFileList

public Widget getFileList()

Deprecated: Superceeded by java-gnome 4.0; a method along these lines may well exist in the new bindings, but if it does it likely has a different name or signature due to the shift to an algorithmic mapping of the underlying native libraries.

Returns the the file list for this widget

Returns: The File List

getFilename

public String getFilename()

Deprecated: Superceeded by java-gnome 4.0; a method along these lines may well exist in the new bindings, but if it does it likely has a different name or signature due to the shift to an algorithmic mapping of the underlying native libraries.

Returns the selected filename.

Returns: The file that is selected in the dialog.

getFileSelection

public static FileSelection getFileSelection(Handle handle)

Deprecated: Superceeded by java-gnome 4.0; a method along these lines may well exist in the new bindings, but if it does it likely has a different name or signature due to the shift to an algorithmic mapping of the underlying native libraries.

Internal static factory method to be used by Java-Gnome only.

getHelpButton

public Button getHelpButton()

Deprecated: Superceeded by java-gnome 4.0; a method along these lines may well exist in the new bindings, but if it does it likely has a different name or signature due to the shift to an algorithmic mapping of the underlying native libraries.

Return the Help Button widget for this dialog.

Returns: The Help Button.

getOKButton

public Button getOKButton()

Deprecated: Superceeded by java-gnome 4.0; a method along these lines may well exist in the new bindings, but if it does it likely has a different name or signature due to the shift to an algorithmic mapping of the underlying native libraries.

Return the OK Button widget for this Dialog.

Returns: The OK Button.

getSelectionEntry

public Widget getSelectionEntry()

Deprecated: Superceeded by java-gnome 4.0; a method along these lines may well exist in the new bindings, but if it does it likely has a different name or signature due to the shift to an algorithmic mapping of the underlying native libraries.

Returns the selection entry

Returns: selection entry

getSelections

public String[] getSelections()

Deprecated: Superceeded by java-gnome 4.0; a method along these lines may well exist in the new bindings, but if it does it likely has a different name or signature due to the shift to an algorithmic mapping of the underlying native libraries.

Retrieves the list of file selections the user has made in the dialog box. This function is intended for use when the user can select multiple files in the file list.

getSelectMultiple

public boolean getSelectMultiple()

Deprecated: Superceeded by java-gnome 4.0; a method along these lines may well exist in the new bindings, but if it does it likely has a different name or signature due to the shift to an algorithmic mapping of the underlying native libraries.

Determines whether or not the user is allowed to select multiple files in the file list.

See Also: FileSelection

getType

public static Type getType()

Deprecated: Superceeded by java-gnome 4.0; a method along these lines may well exist in the new bindings, but if it does it likely has a different name or signature due to the shift to an algorithmic mapping of the underlying native libraries.

Retrieve the runtime type used by the GLib library.

hideFileopButtons

public void hideFileopButtons()

Deprecated: Superceeded by java-gnome 4.0; a method along these lines may well exist in the new bindings, but if it does it likely has a different name or signature due to the shift to an algorithmic mapping of the underlying native libraries.

Hides the file operation buttons that normally appear at the top of the dialog.

setFilename

public void setFilename(String filename)

Deprecated: Superceeded by java-gnome 4.0; a method along these lines may well exist in the new bindings, but if it does it likely has a different name or signature due to the shift to an algorithmic mapping of the underlying native libraries.

Sets the default path for the file requestor. If filename includes a directory path the requestor will open with that path set as its current working directory.

Parameters: filename The default path for the widget.

setSelectMultiple

public void setSelectMultiple(boolean selectMultiple)

Deprecated: Superceeded by java-gnome 4.0; a method along these lines may well exist in the new bindings, but if it does it likely has a different name or signature due to the shift to an algorithmic mapping of the underlying native libraries.

Sets whether the user is allowed to select multiple files in the file list. Use FileSelection to get the list of selected files.

showFileopButtons

public void showFileopButtons()

Deprecated: Superceeded by java-gnome 4.0; a method along these lines may well exist in the new bindings, but if it does it likely has a different name or signature due to the shift to an algorithmic mapping of the underlying native libraries.

Shows the file operation buttons, if they have previously been hidden. The rest of the widgets in the dialog will be resized accordingly.