java-gnome
public class FileChooserDialog extends Dialog implements FileChooser
A FileChooserDialog is just a Dialog with a FileChooserWidget plus
appropriate Buttons that corresponding to the specified
FileChooserAction. Otherwise, all the methods
provided by the FileChooser interface are available which gives you the
necessary power to manipulate the selection received from the Dialog.
Using a FileChooserDialog to open a file could go like this:
FileChooserDialog dialog;
ResponseType response;
// instantiate
dialog = new FileChooserDialog("Open File", window, FileChooserAction.OPEN);
// run the Dialog
response = dialog.run();
dialog.hide();
// deal with the result
if (response == ResponseType.OK) {
open(dialog.getFilename());
}
Dialog.ResponseWindow.ConfigureEvent, Window.DeleteEventWidget.ButtonPressEvent, Widget.ButtonReleaseEvent, Widget.Destroy, Widget.Draw, Widget.EnterNotifyEvent, Widget.FocusInEvent, Widget.FocusOutEvent, Widget.Hide, Widget.KeyPressEvent, Widget.KeyReleaseEvent, Widget.LeaveNotifyEvent, Widget.MapEvent, Widget.MotionNotifyEvent, Widget.PopupMenu, Widget.QueryTooltip, Widget.ScrollEvent, Widget.SizeAllocate, Widget.UnmapEvent, Widget.VisibilityNotifyEvent| Constructor and Description |
|---|
FileChooserDialog(String title,
Window parent,
FileChooserAction action)
Create a new FileChooserDialog.
|
| Modifier and Type | Method and Description |
|---|---|
void |
addFilter(FileFilter filter)
Add a FileFilter to the list of filters that the user can select
between.
|
FileChooserAction |
getAction()
Gets the type of operation that the file chooser is performing.
|
String |
getCurrentFolder()
Get the current folder being displayed in this FileChooser.
|
String |
getFilename()
Get the filename currently selected by this FileChooser.
|
FileFilter |
getFilter()
Gets the current filter.
|
URI |
getURI()
Get the URI representing the file or directory currently selected by
this FileChooser.
|
void |
setAction(FileChooserAction action)
Sets the type of operation that the chooser is performing; the user
interface is adapted to suit the selected action.
|
boolean |
setCurrentFolder(String directory)
Set the current directory for this FileChooser.
|
boolean |
setFilename(String filename)
Set the file you want selected in the FileChooser.
|
void |
setFilter(FileFilter filter)
Sets the current filter; only the files that pass the filter will be
displayed.
|
add, addButton, addButton, addButton, connect, emitResponse, run, setDefaultResponseaddAcceleratorGroup, connect, connect, getHeight, getMaximized, getPositionX, getPositionY, getScreen, getWidth, move, present, resize, setDecorated, setDefaultSize, setFullscreen, setGravity, setHasResizeGrip, setIcon, setIcon, setKeepAbove, setKeepBelow, setMaximize, setModal, setPosition, setResizable, setSkipPagerHint, setSkipTaskbarHint, setStick, setTitle, setTransientFor, setTypeHintgetChildren, remove, setBorderWidthactivate, addEvents, connect, connect, connect, connect, connect, connect, connect, connect, connect, connect, connect, connect, connect, connect, connect, connect, connect, connect, connect, destroy, getAllocatedHeight, getAllocatedWidth, getAllocation, getCanDefault, getCanFocus, getHasFocus, getName, getParent, getPreferredHeightForWidthMinimum, getPreferredHeightForWidthNatural, getPreferredHeightMinimum, getPreferredHeightNatural, getPreferredWidthForHeightMinimum, getPreferredWidthForHeightNatural, getPreferredWidthMinimum, getPreferredWidthNatural, getRequestMode, getRequisition, getSensitive, getStyleContext, getToplevel, getWindow, grabAdd, grabDefault, grabFocus, grabRemove, hide, isSensitive, overrideBackground, overrideColor, overrideFont, queueDraw, queueDrawArea, realize, setAlignHorizontal, setAlignVertical, setCanDefault, setCanFocus, setEvents, setExpandHorizontal, setExpandVertical, setName, setSensitive, setSizeRequest, setTooltipMarkup, setTooltipText, show, showAllpublic FileChooserDialog(String title,
Window parent,
FileChooserAction action)
Buttons appropriate to each of the different FileChooserActions have
been preconfigured in the action area of the Dialog. In all
cases, the executive to go ahead with the action will be the return of
ResponseType OK.
title - the text to use in the title bar of the Dialog Window as
drawn by the window manager, or null if you
want a blank title.parent - the transient parent of the Dialog. While null
is allowed, things are designed to work properly on the
assumption that a parent is specified so it is recommended
that you do so.action - which style of FileChooser you want.public void addFilter(FileFilter filter)
FileChooseraddFilter in interface FileChooserFileFilterpublic FileChooserAction getAction()
FileChoosergetAction in interface FileChooserFileChooser.setAction(FileChooserAction)public String getCurrentFolder()
FileChooserSELECT_FOLDER
mode. To get the currently-selected folder in that mode, you can use
FileChooser.getURI() instead.getCurrentFolder in interface FileChoosernull if if the FileChooser
was unable to load the last folder that was requested of it (as
would happen if calling FileChooser.setCurrentFolder(String) on a
nonexistent directory).FileChooser.getFilename()public String getFilename()
FileChoosergetFilename in interface FileChoosernull. If multiple files are selected, one of the
filenames will be returned at random. If the FileChooser is in
one of the folder modes, this returns the selected folder's
name.public FileFilter getFilter()
FileChooserThis function is specially useful on "Save" FileChoosers, to know the file type chosen by the user.
getFilter in interface FileChooserFileFilterpublic URI getURI()
FileChoosergetURI in interface FileChoosernull. If multiple files are selected,
one of the filenames will be returned at random. If the
FileChooser is in one of the folder modes, this returns the
selected folder's URI.public void setAction(FileChooserAction action)
FileChooserSAVE but not if the action is
OPEN.setAction in interface FileChooserpublic boolean setCurrentFolder(String directory)
FileChoosersetCurrentFolder in interface FileChooserdirectory - the full path of the new current foldertrue if the folder could be changed successfully,
false otherwise.public boolean setFilename(String filename)
FileChooserIf the folder currently showing in the FileChooser isn't the directory containing the filename you specify, then the FileChooser will be changed to that directory.
setFilename in interface FileChooserfilename - Must be an absolute path.true if the the directory was changed (if
necessary) and a file was successfully selected.public void setFilter(FileFilter filter)
FileChooserSetting the current filter when the list of filters is empty is useful if you want to restrict the displayed set of files without letting the user change it.
setFilter in interface FileChooserFileFilter