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

的 FileDialog类显示一个对话框，用户可以选择一个文件。

因为它是一个模态对话框，当应用程序调用它的show方法显示的对话框，它会阻止其他应用程序在用户选择一个文件。

从以下版本开始：

JDK1.0

另请参见：

Window.show()， Serialized Form

Nested Class Summary

Nested classes/interfaces inherited from class java.awt.Dialog

Dialog.AccessibleAWTDialog, Dialog.ModalExclusionType, Dialog.ModalityType

Nested classes/interfaces inherited from class java.awt.Window

Window.AccessibleAWTWindow, Window.Type

Nested classes/interfaces inherited from class java.awt.Container

Container.AccessibleAWTContainer

Nested classes/interfaces inherited from class java.awt.Component

Component.AccessibleAWTComponent, Component.BaselineResizeBehavior, Component.BltBufferStrategy, Component.FlipBufferStrategy

Field Summary

Fields

Modifier and Type	Field and Description
static int	LOAD 这个常量值表示“文件”对话框窗口的目的是找到一个从中读取的文件。
static int	SAVE 这个常量值表示“文件”对话框窗口的目的是找到一个要写入的文件。

Fields inherited from class java.awt.Dialog

DEFAULT_MODALITY_TYPE

Fields inherited from class java.awt.Component

accessibleContext, BOTTOM_ALIGNMENT, CENTER_ALIGNMENT, LEFT_ALIGNMENT, RIGHT_ALIGNMENT, TOP_ALIGNMENT

Fields inherited from interface java.awt.image.ImageObserver

ABORT, ALLBITS, ERROR, FRAMEBITS, HEIGHT, PROPERTIES, SOMEBITS, WIDTH

构造方法摘要

构造方法

Constructor and Description
FileDialog(Dialog parent) 创建一个加载文件的文件对话框。
FileDialog(Dialog parent, String title) 用指定的标题创建一个文件对话框以加载文件。
FileDialog(Dialog parent, String title, int mode) 创建一个具有指定标题的文件对话框，用于加载或保存文件。
FileDialog(Frame parent) 创建一个加载文件的文件对话框。
FileDialog(Frame parent, String title) 用指定的标题创建一个文件对话框以加载文件。
FileDialog(Frame parent, String title, int mode) 创建一个具有指定标题的文件对话框，用于加载或保存文件。

方法摘要

Modifier and Type	Method and Description
void	addNotify() 创建文件对话框的对等点。
String	getDirectory() 获取此文件对话框的目录。
String	getFile() 获取此文件对话框的选定文件。
FilenameFilter	getFilenameFilter() 确定此文件对话框的文件名筛选器。
File[]	getFiles() 返回用户选择的文件。
int	getMode() 指示此文件对话框是否为从文件加载或保存到文件中。
boolean	isMultipleMode() 返回文件对话框是否允许多个文件选择。
protected String	paramString() 返回一个字符串，表示此 FileDialog窗口状态。
void	setDirectory(String dir) 将此文件对话框的目录设置为指定的目录。
void	setFile(String file) 将此文件对话框窗口的选定文件为指定的文件。
void	setFilenameFilter(FilenameFilter filter) 将此文件对话框的文件名筛选器设置为指定的筛选器。
void	setMode(int mode) 设置文件对话框的模式。
void	setMultipleMode(boolean enable) 启用或禁用文件对话框的多个文件选择。

Methods inherited from class java.awt.Dialog

getAccessibleContext, getModalityType, getTitle, hide, isModal, isResizable, isUndecorated, setBackground, setModal, setModalityType, setOpacity, setResizable, setShape, setTitle, setUndecorated, setVisible, show, toBack

Methods inherited from class java.awt.Window

addPropertyChangeListener, 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, 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, paintComponents, preferredSize, print, printComponents, processContainerEvent, remove, remove, removeAll, removeContainerListener, setComponentZOrder, setFocusTraversalKeys, setFocusTraversalPolicy, setFocusTraversalPolicyProvider, setFont, setLayout, 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, 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, transferFocusUpCycle

Methods inherited from class java.lang.Object

clone, equals, finalize, getClass, hashCode, notify, notifyAll, wait, wait, wait

Field Detail

LOAD

public static final int LOAD

这个常量值表示“文件”对话框窗口的目的是找到一个从中读取的文件。

另请参见：

Constant Field Values

SAVE

public static final int SAVE

这个常量值表示“文件”对话框窗口的目的是找到一个要写入的文件。

另请参见：

Constant Field Values

Constructor Detail

FileDialog

public FileDialog(Frame parent)

创建一个加载文件的文件对话框。文件对话框的标题为空。这是一个 FileDialog(parent, "", LOAD)便利的方法。

参数

parent -该对话框的所有者

从以下版本开始：

JDK1.1

FileDialog

public FileDialog(Frame parent,
                  String title)

用指定的标题创建一个文件对话框以加载文件。所显示的文件是当前目录中的文件。这是一个 FileDialog(parent, title, LOAD)便利的方法。

参数

parent -该对话框的所有者

title -对话框的标题

FileDialog

public FileDialog(Frame parent,
                  String title,
                  int mode)

创建一个具有指定标题的文件对话框，用于加载或保存文件。

如果mode值LOAD文件对话框，然后找到一个文件的读取，显示的文件在当前目录。如果mode值SAVE文件对话框，找到一个地方写一个文件。

参数

parent -该对话框的所有者

title -对话框的标题

mode -对话框的模式；要么 FileDialog.LOAD或 FileDialog.SAVE

异常

IllegalArgumentException -如果提供非法文件对话框模式

另请参见：

LOAD， SAVE

FileDialog

public FileDialog(Dialog parent)

创建一个加载文件的文件对话框。文件对话框的标题为空。这是一个 FileDialog(parent, "", LOAD)便利的方法。

参数

parent -该对话框的所有者

异常

IllegalArgumentException -如果 parent的 GraphicsConfiguration不是从一个屏幕的设备；

IllegalArgumentException -如果 parent是 null；这种例外总是扔在 GraphicsEnvironment.isHeadless返回 true

从以下版本开始：

一点五

另请参见：

GraphicsEnvironment.isHeadless()

FileDialog

public FileDialog(Dialog parent,
                  String title)

用指定的标题创建一个文件对话框以加载文件。所显示的文件是当前目录中的文件。这是一个 FileDialog(parent, title, LOAD)便利的方法。

参数

parent -该对话框的所有者

title -对话框的标题；一个 null值将不会造成 NullPointerException被接受

异常

IllegalArgumentException -如果 parent的 GraphicsConfiguration不是从一个屏幕的设备；

IllegalArgumentException -如果 parent是 null；这种例外总是扔在 GraphicsEnvironment.isHeadless返回 true

从以下版本开始：

一点五

另请参见：

GraphicsEnvironment.isHeadless()

FileDialog

public FileDialog(Dialog parent,
                  String title,
                  int mode)

创建一个具有指定标题的文件对话框，用于加载或保存文件。

如果mode值LOAD文件对话框，然后找到一个文件的读取，显示的文件在当前目录。如果mode值SAVE文件对话框，找到一个地方写一个文件。

参数

parent -该对话框的所有者

title -对话框的标题；一个 null值将不会造成 NullPointerException被接受

mode -对话框的模式；要么 FileDialog.LOAD或 FileDialog.SAVE

异常

IllegalArgumentException -如果提供非法文件对话框模式；

IllegalArgumentException -如果 parent的 GraphicsConfiguration不是从一个屏幕的设备；

IllegalArgumentException -如果 parent是 null；这种例外总是扔在 GraphicsEnvironment.isHeadless返回 true

从以下版本开始：

一点五

另请参见：

GraphicsEnvironment.isHeadless()， LOAD， SAVE

方法详细信息

addNotify

public void addNotify()

创建文件对话框的对等点。的对等允许我们改变文件对话框的外观，而不改变其功能。

重写：

addNotify 方法重写，继承类 Dialog

另请参见：

Component.isDisplayable()， Window.removeNotify()

getMode

public int getMode()

指示此文件对话框是否为从文件加载或保存到文件中。

结果

本文件对话框的模式，无论是 FileDialog.LOAD或 FileDialog.SAVE

另请参见：

LOAD， SAVE， setMode(int)

setMode

public void setMode(int mode)

设置文件对话框的模式。如果 mode不是法律价值，将抛出一个异常， mode将不会设置。

参数

mode -该文件对话框的模式，无论是 FileDialog.LOAD或 FileDialog.SAVE

异常

IllegalArgumentException -如果提供非法文件对话框模式

从以下版本开始：

JDK1.1

另请参见：

LOAD， SAVE， getMode()

getDirectory

public String getDirectory()

获取此文件对话框的目录。

结果

的（潜在的 null或无效）这 FileDialog目录

另请参见：

setDirectory(java.lang.String)

setDirectory

public void setDirectory(String dir)

将此文件对话框的目录设置为指定的目录。指定一个 null或无效的目录是由实现定义的默认。此默认将不会实现，但是，直到用户选择了一个文件。直到此时， getDirectory()将返回传递给这个方法的价值。

指定“”的目录是完全等同于指定的目录null。

参数

dir -指定的目录

另请参见：

getDirectory()

getFile

public String getFile()

获取此文件对话框的选定文件。如果用户选择的 CANCEL，返回的文件 null。

结果

当前选择的这个文件对话框窗口的文件，或 null如果没有选择

另请参见：

setFile(java.lang.String)

getFiles

public File[] getFiles()

返回用户选择的文件。

如果用户取消了文件对话框，则该方法返回一个空数组。

结果

如果用户取消了文件对话框，则用户选择或一个空数组的文件。

从以下版本开始：

一点七

另请参见：

setFile(String)， getFile()

setFile

public void setFile(String file)

将此文件对话框窗口的选定文件为指定的文件。此文件将成为默认的文件，如果它是在“文件”对话框窗口之前被设置的。

当显示对话框时，选择指定的文件。该类型的选择取决于文件的存在、对话框类型和本地平台的类型。例如，文件可以在文件列表中突出显示，或文件名编辑框可以填入文件名。

这个方法接受一个完整的文件路径或文件名和扩展如果与setDirectory方法一起使用。

指定“”的文件是完全等同于指定的文件null。

参数

file -设置文件

另请参见：

getFile()， getFiles()

setMultipleMode

public void setMultipleMode(boolean enable)

启用或禁用文件对话框的多个文件选择。

参数

enable -如果 true，选择多个文件启用； false残疾。

从以下版本开始：

一点七

另请参见：

isMultipleMode()

isMultipleMode

public boolean isMultipleMode()

返回文件对话框是否允许多个文件选择。

结果

true如果文件对话框允许选择多个文件； false否则。

从以下版本开始：

一点七

另请参见：

setMultipleMode(boolean)

getFilenameFilter

public FilenameFilter getFilenameFilter()

确定此文件对话框的文件名筛选器。一个文件名过滤器允许用户指定在文件对话框窗口中出现的文件。文件名过滤器不在太阳的参考实现微软窗口中的功能。

结果

这个文件对话框的文件名过滤器

另请参见：

FilenameFilter， setFilenameFilter(java.io.FilenameFilter)

setFilenameFilter

public void setFilenameFilter(FilenameFilter filter)

将此文件对话框的文件名筛选器设置为指定的筛选器。文件名过滤器不在太阳的参考实现微软窗口中的功能。

参数

filter -指定的过滤器

另请参见：

FilenameFilter， getFilenameFilter()

paramString

protected String paramString()

返回一个字符串，表示此 FileDialog窗口状态。此方法仅用于调试目的，返回的字符串的内容和格式可能会在实现过程中有所不同。返回的字符串是空的但可能不 null。

重写：

paramString 方法重写，继承类 Dialog

结果

此文件对话框窗口的参数字符串