当前页面:
在线文档首页 >
JDK 5 Documentation v6.0, Java 2 SDK 英文文档
FileDialog (Java Platform SE 6) - JDK 5 Documentation v6.0, Java 2 SDK 英文文档
java.awt
Class FileDialog
java.lang.Object
java.awt.Component
java.awt.Container
java.awt.Window
java.awt.Dialog
java.awt.FileDialog
- All Implemented Interfaces:
- ImageObserver, MenuContainer, Serializable, Accessible
public class FileDialog
- extends Dialog
The 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.
- Since:
- JDK1.0
- See Also:
Window.show(),
Serialized Form
|
Field Summary |
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. |
|
Constructor Summary |
FileDialog(Dialog parent)
Creates a file dialog for loading a file. |
FileDialog(Dialog parent,
String title)
Creates a file dialog window with the specified title for loading
a file. |
FileDialog(Dialog parent,
String title,
int mode)
Creates a file dialog window with the specified title for loading
or saving a file. |
FileDialog(Frame parent)
Creates a file dialog for loading a file. |
FileDialog(Frame parent,
String title)
Creates a file dialog window with the specified title for loading
a file. |
FileDialog(Frame parent,
String title,
int mode)
Creates a file dialog window with the specified title for loading
or saving a file. |
|
Method Summary |
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. |
int |
getMode()
Indicates whether this file dialog box is for loading from a file
or for saving to a file. |
protected String |
paramString()
Returns a string representing the state of this FileDialog
window. |
void |
setDirectory(String dir)
Sets the directory of this file dialog window to be the
specified directory. |
void |
setFile(String file)
Sets the selected file for this file dialog window to be the
specified file. |
void |
setFilenameFilter(FilenameFilter filter)
Sets the filename filter for this file dialog window to the
specified filter. |
void |
setMode(int mode)
Sets the mode of the file dialog. |
| Methods inherited from class java.awt.Dialog |
getAccessibleContext, getModalityType, getTitle, hide, isModal, isResizable, isUndecorated, setModal, setModalityType, setResizable, setTitle, setUndecorated, setVisible, show, toBack |
| Methods inherited from class java.awt.Window |
addPropertyChangeListener, addPropertyChangeListener, addWindowFocusListener, addWindowListener, addWindowStateListener, applyResourceBundle, applyResourceBundle, createBufferStrategy, createBufferStrategy, dispose, getBufferStrategy, getFocusableWindowState, getFocusCycleRootAncestor, getFocusOwner, getFocusTraversalKeys, getGraphicsConfiguration, getIconImages, getInputContext, getListeners, getLocale, getModalExclusionType, getMostRecentFocusOwner, getOwnedWindows, getOwner, getOwnerlessWindows, getToolkit, getWarningString, getWindowFocusListeners, getWindowListeners, getWindows, getWindowStateListeners, isActive, isAlwaysOnTop, isAlwaysOnTopSupported, isFocusableWindow, isFocusCycleRoot, isFocused, isLocationByPlatform, isShowing, pack, postEvent, processEvent, processWindowEvent, processWindowFocusEvent, processWindowStateEvent, removeNotify, removeWindowFocusListener, removeWindowListener, removeWindowStateListener, reshape, setAlwaysOnTop, setBounds, setBounds, setCursor, setFocusableWindowState, setFocusCycleRoot, setIconImage, setIconImages, setLocationByPlatform, setLocationRelativeTo, setMinimumSize, setModalExclusionType, setSize, setSize, toFront |
| Methods inherited from class java.awt.Container |
add, 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, paint, paintComponents, preferredSize, print, printComponents, processContainerEvent, remove, remove, removeAll, removeContainerListener, setComponentZOrder, setFocusTraversalKeys, setFocusTraversalPolicy, setFocusTraversalPolicyProvider, setFont, setLayout, transferFocusBackward, transferFocusDownCycle, update, validate, validateTree |
| Methods inherited from class java.awt.Component |
action, 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, getBackground, getBaseline, getBaselineResizeBehavior, getBounds, getBounds, getColorModel, getComponentListeners, getComponentOrientation, getCursor, getDropTarget, getFocusListeners, getFocusTraversalKeysEnabled, getFont, getFontMetrics, getForeground, getGraphics, 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, isOpaque, 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, setBackground, setComponentOrientation, setDropTarget, setEnabled, setFocusable, setFocusTraversalKeysEnabled, setForeground, setIgnoreRepaint, setLocale, setLocation, setLocation, setMaximumSize, setName, setPreferredSize, show, size, toString, transferFocus, transferFocusUpCycle |
LOAD
public static final int LOAD
- This constant value indicates that the purpose of the file
dialog window is to locate a file from which to read.
- See Also:
- Constant Field Values
SAVE
public static final int SAVE
- This constant value indicates that the purpose of the file
dialog window is to locate a file to which to write.
- See Also:
- Constant Field Values
FileDialog
public FileDialog(Frame parent)
- Creates a file dialog for loading a file. The title of the
file dialog is initially empty. This is a convenience method for
FileDialog(parent, "", LOAD).
- Parameters:
parent - the owner of the dialog- Since:
- JDK1.1
FileDialog
public FileDialog(Frame parent,
String title)
- Creates a file dialog window with the specified title for loading
a file. The files shown are those in the current directory.
This is a convenience method for
FileDialog(parent, title, LOAD).
- Parameters:
parent - the owner of the dialogtitle - the title of the dialog
FileDialog
public FileDialog(Frame parent,
String title,
int mode)
- Creates a file dialog window with the specified title for loading
or saving a file.
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.
- Parameters:
parent - the owner of the dialogtitle - the title of the dialogmode - the mode of the dialog; either
FileDialog.LOAD or FileDialog.SAVE
- Throws:
IllegalArgumentException - if an illegal file
dialog mode is supplied- See Also:
LOAD,
SAVE
FileDialog
public FileDialog(Dialog parent)
- Creates a file dialog for loading a file. The title of the
file dialog is initially empty. This is a convenience method for
FileDialog(parent, "", LOAD).
- Parameters:
parent - the owner of the dialog
- Throws:
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- Since:
- 1.5
- See Also:
GraphicsEnvironment.isHeadless()
FileDialog
public FileDialog(Dialog parent,
String title)
- Creates a file dialog window with the specified title for loading
a file. The files shown are those in the current directory.
This is a convenience method for
FileDialog(parent, title, LOAD).
- Parameters:
parent - the owner of the dialogtitle - the title of the dialog; a null value
will be accepted without causing a
NullPointerException to be thrown
- Throws:
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- Since:
- 1.5
- See Also:
GraphicsEnvironment.isHeadless()
FileDialog
public FileDialog(Dialog parent,
String title,
int mode)
- Creates a file dialog window with the specified title for loading
or saving a file.
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.
- Parameters:
parent - the owner of the dialogtitle - the title of the dialog; a null value
will be accepted without causing a
NullPointerException to be thrownmode - the mode of the dialog; either
FileDialog.LOAD or FileDialog.SAVE
- Throws:
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- Since:
- 1.5
- See Also:
GraphicsEnvironment.isHeadless(),
LOAD,
SAVE
addNotify
public void addNotify()
- Creates the file dialog's peer. The peer allows us to change the look
of the file dialog without changing its functionality.
- Overrides:
addNotify in class Dialog
- See Also:
Component.isDisplayable(),
Window.removeNotify()
getMode
public int getMode()
- Indicates whether this file dialog box is for loading from a file
or for saving to a file.
- Returns:
- the mode of this file dialog window, either
FileDialog.LOAD or
FileDialog.SAVE - See Also:
LOAD,
SAVE,
setMode(int)
setMode
public void setMode(int mode)
- Sets the mode of the file dialog. If
mode is not
a legal value, an exception will be thrown and mode
will not be set.
- Parameters:
mode - the mode for this file dialog, either
FileDialog.LOAD or
FileDialog.SAVE
- Throws:
IllegalArgumentException - if an illegal file
dialog mode is supplied- Since:
- JDK1.1
- See Also:
LOAD,
SAVE,
getMode()
getDirectory
public String getDirectory()
- Gets the directory of this file dialog.
- Returns:
- the (potentially
null or invalid)
directory of this FileDialog - See Also:
setDirectory(java.lang.String)
setDirectory
public void setDirectory(String dir)
- Sets the directory of this file dialog window to be the
specified directory. Specifying a
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.
- Parameters:
dir - the specified directory- See Also:
getDirectory()
getFile
public String getFile()
- Gets the selected file of this file dialog. If the user
selected
CANCEL, the returned file is null.
- Returns:
- the currently selected file of this file dialog window,
or
null if none is selected - See Also:
setFile(java.lang.String)
setFile
public void setFile(String file)
- Sets the selected file for this file dialog window to be the
specified file. This file becomes the default file if it is set
before the file dialog window is first shown.
Specifying "" as the file is exactly equivalent to specifying
null
as the file.
- Parameters:
file - the file being set- See Also:
getFile()
getFilenameFilter
public FilenameFilter getFilenameFilter()
- Determines this file dialog's filename filter. A filename filter
allows the user to specify which files appear in the file dialog
window. Filename filters do not function in Sun's reference
implementation for Microsoft Windows.
- Returns:
- this file dialog's filename filter
- See Also:
FilenameFilter,
setFilenameFilter(java.io.FilenameFilter)
setFilenameFilter
public void setFilenameFilter(FilenameFilter filter)
- Sets the filename filter for this file dialog window to the
specified filter.
Filename filters do not function in Sun's reference
implementation for Microsoft Windows.
- Parameters:
filter - the specified filter- See Also:
FilenameFilter,
getFilenameFilter()
paramString
protected String paramString()
- Returns a string representing the state of this
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.
- Overrides:
paramString in class Dialog
- Returns:
- the parameter string of this file dialog window
Submit a bug or feature
For further API reference and developer documentation, see Java SE Developer Documentation. That documentation contains more detailed, developer-targeted descriptions, with conceptual overviews, definitions of terms, workarounds, and working code examples. Copyright 2006 Sun Microsystems, Inc. All rights reserved. Use is subject to license terms. Also see the documentation redistribution policy.
