org.gnu.gtk

Class FileSelection


public class FileSelection
extends Dialog

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(Handle handle)
Construct a FileSelection using a handle to a native resource.
FileSelection(String title)
construct a new FileSelection dialog.

Method Summary

void
complete(String pattern)
Will attempt to match pattern to a valid filename or subdirectory in the current directory.
Button
getCancelButton()
Return the Cancel Button widget for this dialog.
Widget
getDirList()
Return the directory list for this widget
Widget
getFileList()
Returns the the file list for this widget
static FileSelection
getFileSelection(Handle handle)
Internal static factory method to be used by Java-Gnome only.
String
getFilename()
Returns the selected filename.
Button
getHelpButton()
Return the Help Button widget for this dialog.
Button
getOKButton()
Return the OK Button widget for this Dialog.
boolean
getSelectMultiple()
Determines whether or not the user is allowed to select multiple files in the file list.
Widget
getSelectionEntry()
Returns the selection entry
String[]
getSelections()
Retrieves the list of file selections the user has made in the dialog box.
static Type
getType()
Retrieve the runtime type used by the GLib library.
void
hideFileopButtons()
Hides the file operation buttons that normally appear at the top of the dialog.
void
setFilename(String filename)
Sets the default path for the file requestor.
void
setSelectMultiple(boolean selectMultiple)
Sets whether the user is allowed to select multiple files in the file list.
void
showFileopButtons()
Shows the file operation buttons, if they have previously been hidden.

Methods inherited from class org.gnu.gtk.Dialog

addButton, addButton, addListener, addWidget, getActionArea, getDialog, getDialogLayout, getEventListenerClass, getEventType, getHasSeparator, getResponseForWidget, getType, removeListener, run, setDefaultResponse, setHasSeparator

Methods inherited from class org.gnu.gtk.Window

addAccelGroup, deiconify, destroy, fullscreen, getAcceptFocus, getDefaultIconList, getFocusOnMap, getFocusWidget, getGravity, getIcon, getIconList, getIconName, getPosition, getScreen, getSize, getSkipPagerHint, getSkipTaskbarHint, getTitle, getTransientParent, getType, getWindow, hasToplevelFocus, iconify, isActive, isDestroyed, listToplevelWindows, maximize, move, present, removeAccelGroup, resize, setAcceptFocus, setAutoStartupNotification, setDecorated, setDefaultIcon, setDefaultIconFromFile, setDefaultIconList, setDefaultIconName, setDefaultSize, setDefaultWidget, setFocusOnMap, setFocusWidget, setGeometryHints, setGravity, setIcon, setIconFromFile, setIconList, setIconName, setKeepAbove, setKeepBelow, setModal, setPosition, setResizable, setScreen, setSkipPagerHint, setSkipTaskbarHint, setTitle, setTransientParent, stick, unfullscreen, unmaximize, unstick

Methods inherited from class org.gnu.gtk.Bin

getChild, getType

Methods inherited from class org.gnu.gtk.Container

add, addListener, getBorderWidth, getChildren, getEventListenerClass, getEventType, getResizeMode, getType, remove, removeListener, resizeChildren, setBorderWidth, setResizeMode

Methods inherited from class org.gnu.gtk.Widget

activate, addAccelerator, addEvents, addListener, addListener, addListener, addListener, addListener, addListener, addListener, addListener, addListener, addListener, addListener, canActivateAccel, createContext, createLayout, draw, drawArea, drawArea, finish, getAccessible, getAllocation, getColormap, getContext, getData, getDisplay, getDragData, getEventListenerClass, getEventType, getExtensionEvents, getModifierStyle, getName, getParent, getParentWindow, getPointer, getRootWindow, getScreen, getSensitive, getStyle, getToplevel, getType, getWidget, getWindow, grabDefault, grabFocus, hasFocus, hasScreen, hide, hideAll, highlight, highlight, intersect, isAncestor, makeWidget, modifyStyle, popColormap, pushColormap, realize, removeAccelerator, removeListener, removeListener, removeListener, removeListener, removeListener, removeListener, removeListener, removeListener, removeListener, removeListener, removeListener, reparent, setBackgroundColor, setBaseColor, setColormap, setDoubleBuffered, setDragDestination, setDragIcon, setDragIconPixbuf, setDragIconStock, setDragSource, setEvents, setExtensionEvents, setFont, setForegroundColor, setMinimumSize, setName, setNoDragDestination, setNoDragSource, setSensitive, setTextColor, shapeCombineMask, show, showAll, unHighlight, unHighlight

Methods inherited from class org.gnu.gtk.GtkObject

destroy, getType, sink

Methods inherited from class org.gnu.glib.GObject

addEventHandler, addEventHandler, addEventHandler, addEventHandler, addEventHandler, addEventHandler, addEventHandler, addListener, collect, freezeNotify, getBooleanProperty, getData, getDoubleProperty, getEventListenerClass, getEventType, getFloatProperty, getGObjectFromHandle, getIntProperty, getJavaObjectProperty, getLongProperty, getPixbufProperty, getProperty, getStringProperty, hasProperty, notify, removeEventHandler, removeListener, setBooleanProperty, setData, setDoubleProperty, setFloatProperty, setIntProperty, setJavaObjectProperty, setLongProperty, setPixbufProperty, setProperty, setStringProperty, thawNotify

Constructor Details

FileSelection

public FileSelection(Handle handle)
Construct a FileSelection using a handle to a native resource.

FileSelection

public FileSelection(String title)
construct a new FileSelection dialog.
Parameters:
title - The string that is displayed in the title bar of the dialog.

Method Details

complete

public void complete(String pattern)
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()
Return the Cancel Button widget for this dialog.
Returns:
The Cancel Button.

getDirList

public Widget getDirList()
Return the directory list for this widget
Returns:
The Directory List

getFileList

public Widget getFileList()
Returns the the file list for this widget
Returns:
The File List

getFileSelection

public static FileSelection getFileSelection(Handle handle)
Internal static factory method to be used by Java-Gnome only.

getFilename

public String getFilename()
Returns the selected filename.
Returns:
The file that is selected in the dialog.

getHelpButton

public Button getHelpButton()
Return the Help Button widget for this dialog.
Returns:
The Help Button.

getOKButton

public Button getOKButton()
Return the OK Button widget for this Dialog.
Returns:
The OK Button.

getSelectMultiple

public boolean getSelectMultiple()
Determines whether or not the user is allowed to select multiple files in the file list.

getSelectionEntry

public Widget getSelectionEntry()
Returns the selection entry
Returns:
selection entry

getSelections

public String[] getSelections()
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.

getType

public static Type getType()
Retrieve the runtime type used by the GLib library.
Overrides:
getType in interface Dialog

hideFileopButtons

public void hideFileopButtons()
Hides the file operation buttons that normally appear at the top of the dialog.

setFilename

public void setFilename(String filename)
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)

showFileopButtons

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