public class FileDialog extends Dialog
FileDialog class displays a dialog window from which the user can select a file.
Since it is a modal dialog, when the application calls its show method to display the dialog, it blocks the rest of the application until the user has chosen a file.
Window.show() ,
Serialized Form
Dialog.AccessibleAWTDialog , Dialog.ModalExclusionType , Dialog.ModalityType Window.AccessibleAWTWindow , Window.Type Container.AccessibleAWTContainer Component.AccessibleAWTComponent , Component.BaselineResizeBehavior , Component.BltBufferStrategy , Component.FlipBufferStrategy | Modifier and Type | Field and Description |
|---|---|
static int |
LOAD
This constant value indicates that the purpose of the file dialog window is to locate a file from which to read.
|
static int |
SAVE
This constant value indicates that the purpose of the file dialog window is to locate a file to which to write.
|
DEFAULT_MODALITY_TYPEaccessibleContext, BOTTOM_ALIGNMENT, CENTER_ALIGNMENT, LEFT_ALIGNMENT, RIGHT_ALIGNMENT, TOP_ALIGNMENTABORT, ALLBITS, ERROR, FRAMEBITS, HEIGHT, PROPERTIES, SOMEBITS, WIDTH| Constructor and Description |
|---|
FileDialog(Dialog
Creates a file dialog for loading a file.
|
FileDialog(Dialog
Creates a file dialog window with the specified title for loading a file.
|
FileDialog(Dialog
Creates a file dialog window with the specified title for loading or saving a file.
|
FileDialog(Frame
Creates a file dialog for loading a file.
|
FileDialog(Frame
Creates a file dialog window with the specified title for loading a file.
|
FileDialog(Frame
Creates a file dialog window with the specified title for loading or saving a file.
|
| Modifier and Type | Method and Description |
|---|---|
void |
addNotify()
Creates the file dialog's peer.
|
String |
getDirectory()
Gets the directory of this file dialog.
|
String |
getFile()
Gets the selected file of this file dialog.
|
FilenameFilter |
getFilenameFilter()
Determines this file dialog's filename filter.
|
File |
getFiles()
Returns files that the user selects.
|
int |
getMode()
Indicates whether this file dialog box is for loading from a file or for saving to a file.
|
boolean |
isMultipleMode()
Returns whether the file dialog allows the multiple file selection.
|
protected String |
paramString()
Returns a string representing the state of this
FileDialog window.
|
void |
setDirectory(String
Sets the directory of this file dialog window to be the specified directory.
|
void |
setFile(String
Sets the selected file for this file dialog window to be the specified file.
|
void |
setFilenameFilter(FilenameFilter
Sets the filename filter for this file dialog window to the specified filter.
|
void |
setMode(int mode)
Sets the mode of the file dialog.
|
void |
setMultipleMode(boolean enable)
Enables or disables multiple file selection for the file dialog.
|
getAccessibleContext, getModalityType, getTitle, hide, isModal, isResizable, isUndecorated, setBackground, setModal, setModalityType, setOpacity, setResizable, setShape, setTitle, setUndecorated, setVisible, show, toBackaddPropertyChangeListener, addPropertyChangeListener, addWindowFocusListener, addWindowListener, addWindowStateListener, applyResourceBundle, applyResourceBundle, createBufferStrategy, createBufferStrategy, dispose, getBackground, getBufferStrategy, getFocusableWindowState, getFocusCycleRootAncestor, getFocusOwner, getFocusTraversalKeys, getIconImages, getInputContext, getListeners, getLocale, getModalExclusionType, getMostRecentFocusOwner, getOpacity, getOwnedWindows, getOwner, getOwnerlessWindows, getShape, getToolkit, getType, getWarningString, getWindowFocusListeners, getWindowListeners, getWindows, getWindowStateListeners, isActive, isAlwaysOnTop, isAlwaysOnTopSupported, isAutoRequestFocus, isFocusableWindow, isFocusCycleRoot, isFocused, isLocationByPlatform, isOpaque, isShowing, isValidateRoot, pack, paint, postEvent, processEvent, processWindowEvent, processWindowFocusEvent, processWindowStateEvent, removeNotify, removeWindowFocusListener, removeWindowListener, removeWindowStateListener, reshape, setAlwaysOnTop, setAutoRequestFocus, setBounds, setBounds, setCursor, setFocusableWindowState, setFocusCycleRoot, setIconImage, setIconImages, setLocation, setLocation, setLocationByPlatform, setLocationRelativeTo, setMinimumSize, setModalExclusionType, setSize, setSize, setType, toFrontadd, add, add, add, add, addContainerListener, addImpl, applyComponentOrientation, areFocusTraversalKeysSet, countComponents, deliverEvent, doLayout, findComponentAt, findComponentAt, getAlignmentX, getAlignmentY, getComponent, getComponentAt, getComponentAt, getComponentCount, getComponents, getComponentZOrder, getContainerListeners, getFocusTraversalPolicy, getInsets, getLayout, getMaximumSize, getMinimumSize, getMousePosition, getPreferredSize, insets, invalidate, isAncestorOf, isFocusCycleRoot, isFocusTraversalPolicyProvider, isFocusTraversalPolicySet, layout, list, list, locate, minimumSize, paintComponents, preferredSize, print, printComponents, processContainerEvent, remove, remove, removeAll, removeContainerListener, setComponentZOrder, setFocusTraversalKeys, setFocusTraversalPolicy, setFocusTraversalPolicyProvider, setFont, setLayout, transferFocusDownCycle, update, validate, validateTreeaction, add, addComponentListener, addFocusListener, addHierarchyBoundsListener, addHierarchyListener, addInputMethodListener, addKeyListener, addMouseListener, addMouseMotionListener, addMouseWheelListener, bounds, checkImage, checkImage, coalesceEvents, contains, contains, createImage, createImage, createVolatileImage, createVolatileImage, disable, disableEvents, dispatchEvent, enable, enable, enableEvents, enableInputMethods, firePropertyChange, firePropertyChange, firePropertyChange, firePropertyChange, firePropertyChange, firePropertyChange, firePropertyChange, firePropertyChange, firePropertyChange, getBaseline, getBaselineResizeBehavior, getBounds, getBounds, getColorModel, getComponentListeners, getComponentOrientation, getCursor, getDropTarget, getFocusListeners, getFocusTraversalKeysEnabled, getFont, getFontMetrics, getForeground, getGraphics, getGraphicsConfiguration, getHeight, getHierarchyBoundsListeners, getHierarchyListeners, getIgnoreRepaint, getInputMethodListeners, getInputMethodRequests, getKeyListeners, getLocation, getLocation, getLocationOnScreen, getMouseListeners, getMouseMotionListeners, getMousePosition, getMouseWheelListeners, getName, getParent, getPeer, getPropertyChangeListeners, getPropertyChangeListeners, getSize, getSize, getTreeLock, getWidth, getX, getY, gotFocus, handleEvent, hasFocus, imageUpdate, inside, isBackgroundSet, isCursorSet, isDisplayable, isDoubleBuffered, isEnabled, isFocusable, isFocusOwner, isFocusTraversable, isFontSet, isForegroundSet, isLightweight, isMaximumSizeSet, isMinimumSizeSet, isPreferredSizeSet, isValid, isVisible, keyDown, keyUp, list, list, list, location, lostFocus, mouseDown, mouseDrag, mouseEnter, mouseExit, mouseMove, mouseUp, move, nextFocus, paintAll, prepareImage, prepareImage, printAll, processComponentEvent, processFocusEvent, processHierarchyBoundsEvent, processHierarchyEvent, processInputMethodEvent, processKeyEvent, processMouseEvent, processMouseMotionEvent, processMouseWheelEvent, remove, removeComponentListener, removeFocusListener, removeHierarchyBoundsListener, removeHierarchyListener, removeInputMethodListener, removeKeyListener, removeMouseListener, removeMouseMotionListener, removeMouseWheelListener, removePropertyChangeListener, removePropertyChangeListener, repaint, repaint, repaint, repaint, requestFocus, requestFocus, requestFocusInWindow, requestFocusInWindow, resize, resize, revalidate, setComponentOrientation, setDropTarget, setEnabled, setFocusable, setFocusTraversalKeysEnabled, setForeground, setIgnoreRepaint, setLocale, setMaximumSize, setName, setPreferredSize, show, size, toString, transferFocus, transferFocusBackward, transferFocusUpCyclepublic static final int LOAD
public static final int SAVE
public FileDialog(Frameparent)
FileDialog(parent, "", LOAD).
parent - the owner of the dialog
public FileDialog(Frameparent, String title)
FileDialog(parent, title, LOAD).
parent - the owner of the dialog
title - the title of the dialog
public FileDialog(Frameparent, String title, int mode)
If the value of mode is LOAD, then the file dialog is finding a file to read, and the files shown are those in the current directory. If the value of mode is SAVE, the file dialog is finding a place to write a file.
parent - the owner of the dialog
title - the title of the dialog
mode - the mode of the dialog; either
FileDialog.LOAD or
FileDialog.SAVE
IllegalArgumentException - if an illegal file dialog mode is supplied
LOAD,
SAVE
public FileDialog(Dialogparent)
FileDialog(parent, "", LOAD).
parent - the owner of the dialog
IllegalArgumentException - if the
parent's
GraphicsConfiguration is not from a screen device;
IllegalArgumentException - if
parent is
null; this exception is always thrown when
GraphicsEnvironment.isHeadless returns
true
GraphicsEnvironment.isHeadless()
public FileDialog(Dialogparent, String title)
FileDialog(parent, title, LOAD).
parent - the owner of the dialog
title - the title of the dialog; a
null value will be accepted without causing a
NullPointerException to be thrown
IllegalArgumentException - if the
parent's
GraphicsConfiguration is not from a screen device;
IllegalArgumentException - if
parent is
null; this exception is always thrown when
GraphicsEnvironment.isHeadless returns
true
GraphicsEnvironment.isHeadless()
public FileDialog(Dialogparent, String title, int mode)
If the value of mode is LOAD, then the file dialog is finding a file to read, and the files shown are those in the current directory. If the value of mode is SAVE, the file dialog is finding a place to write a file.
parent - the owner of the dialog
title - the title of the dialog; a
null value will be accepted without causing a
NullPointerException to be thrown
mode - the mode of the dialog; either
FileDialog.LOAD or
FileDialog.SAVE
IllegalArgumentException - if an illegal file dialog mode is supplied;
IllegalArgumentException - if the
parent's
GraphicsConfiguration is not from a screen device;
IllegalArgumentException - if
parent is
null; this exception is always thrown when
GraphicsEnvironment.isHeadless returns
true
GraphicsEnvironment.isHeadless() ,
LOAD,
SAVE
public void addNotify()
addNotify in class
Dialog
Component.isDisplayable() ,
Window.removeNotify()
public int getMode()
FileDialog.LOAD or
FileDialog.SAVE
LOAD,
SAVE,
setMode(int)
public void setMode(int mode)
mode is not a legal value, an exception will be thrown and
mode will not be set.
mode - the mode for this file dialog, either
FileDialog.LOAD or
FileDialog.SAVE
IllegalArgumentException - if an illegal file dialog mode is supplied
LOAD,
SAVE,
getMode()
public StringgetDirectory()
null or invalid) directory of this
FileDialog
setDirectory(java.lang.String)
public void setDirectory(Stringdir)
null or an invalid directory implies an implementation-defined default. This default will not be realized, however, until the user has selected a file. Until this point,
getDirectory() will return the value passed into this method.
Specifying "" as the directory is exactly equivalent to specifying null as the directory.
dir - the specified directory
getDirectory()
public StringgetFile()
CANCEL, the returned file is
null.
null if none is selected
setFile(java.lang.String)
public File[] getFiles()
If the user cancels the file dialog, then the method returns an empty array.
setFile(String),
getFile()
public void setFile(Stringfile)
When the dialog is shown, the specified file is selected. The kind of selection depends on the file existence, the dialog type, and the native platform. E.g., the file could be highlighted in the file list, or a file name editbox could be populated with the file name.
This method accepts either a full file path, or a file name with an extension if used together with the setDirectory method.
Specifying "" as the file is exactly equivalent to specifying null as the file.
file - the file being set
getFile(),
getFiles()
public void setMultipleMode(boolean enable)
enable - if
true, multiple file selection is enabled;
false - disabled.
isMultipleMode()
public boolean isMultipleMode()
true if the file dialog allows the multiple file selection;
false otherwise.
setMultipleMode(boolean)
public FilenameFiltergetFilenameFilter()
FilenameFilter,
setFilenameFilter(java.io.FilenameFilter)
public void setFilenameFilter(FilenameFilterfilter)
filter - the specified filter
FilenameFilter,
getFilenameFilter()
protected StringparamString()
FileDialog window. This method is intended to be used only for debugging purposes, and the content and format of the returned string may vary between implementations. The returned string may be empty but may not be
null.
paramString in class
Dialog