public class FileChooserWidget extends VBox implements FileChooser
Note that in most cases you don't need this at all! If you only want to
provide a way to let user select a file, FileChooserDialog
or
FileChooserButton
are much better alternatives.
Widget.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 |
---|
FileChooserWidget(FileChooserAction action)
Create a new FileChooserWidget.
|
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.
|
getOrientation, getSpacing, packEnd, packStart, reorderChild, setOrientation, setSpacing
add, getChildren, remove, setBorderWidth
activate, 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, showAll
public FileChooserWidget(FileChooserAction action)
public void addFilter(FileFilter filter)
FileChooser
addFilter
in interface FileChooser
FileFilter
public FileChooserAction getAction()
FileChooser
getAction
in interface FileChooser
FileChooser.setAction(FileChooserAction)
public String getCurrentFolder()
FileChooser
SELECT_FOLDER
mode. To get the currently-selected folder in that mode, you can use
FileChooser.getURI()
instead.getCurrentFolder
in interface FileChooser
null
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()
FileChooser
getFilename
in interface FileChooser
null
. 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()
FileChooser
This function is specially useful on "Save" FileChoosers, to know the file type chosen by the user.
getFilter
in interface FileChooser
FileFilter
public URI getURI()
FileChooser
getURI
in interface FileChooser
null
. 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)
FileChooser
SAVE
but not if the action is
OPEN
.setAction
in interface FileChooser
public boolean setCurrentFolder(String directory)
FileChooser
setCurrentFolder
in interface FileChooser
directory
- the full path of the new current foldertrue
if the folder could be changed successfully,
false
otherwise.public boolean setFilename(String filename)
FileChooser
If 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 FileChooser
filename
- 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)
FileChooser
Setting 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 FileChooser
FileFilter