- 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
方法来显示对话框时,它将阻止应用程序的其余部分,直到用户选择一个文件。- 从以下版本开始:
- 1.0
- 另请参见:
-
Window.show()
, Serialized Form
-
-
Nested Class Summary
-
Nested classes/interfaces inherited from class java.awt.Component
Component.AccessibleAWTComponent, Component.BaselineResizeBehavior, Component.BltBufferStrategy, Component.FlipBufferStrategy
-
Nested classes/interfaces inherited from class java.awt.Container
Container.AccessibleAWTContainer
-
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
-
-
Field Summary
Fields Modifier and Type Field 描述 static int
LOAD
该常量值表示文件对话窗口的目的是找到要从中读取的文件。static int
SAVE
该常量值表示文件对话窗口的目的是找到要写入的文件。-
Fields inherited from class java.awt.Component
accessibleContext, BOTTOM_ALIGNMENT, CENTER_ALIGNMENT, LEFT_ALIGNMENT, RIGHT_ALIGNMENT, TOP_ALIGNMENT
-
Fields inherited from class java.awt.Dialog
DEFAULT_MODALITY_TYPE
-
Fields inherited from interface java.awt.image.ImageObserver
ABORT, ALLBITS, ERROR, FRAMEBITS, HEIGHT, PROPERTIES, SOMEBITS, WIDTH
-
-
构造方法摘要
构造方法 Constructor 描述 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 方法 描述 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)
启用或禁用文件对话框的多个文件选择。void
setTitle(String title)
设置对话框的标题。-
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, 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, requestFocus, requestFocus, requestFocusInWindow, requestFocusInWindow, requestFocusInWindow, resize, resize, revalidate, setComponentOrientation, setDropTarget, setEnabled, setFocusable, setFocusTraversalKeysEnabled, setForeground, setIgnoreRepaint, setLocale, setMaximumSize, setMixingCutoutShape, setName, setPreferredSize, show, size, toString, transferFocus, transferFocusBackward, transferFocusUpCycle
-
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.Dialog
getAccessibleContext, getModalityType, getTitle, hide, isModal, isResizable, isUndecorated, setBackground, setModal, setModalityType, setOpacity, setResizable, setShape, setUndecorated, setVisible, show, toBack
-
Methods inherited from class java.lang.Object
clone, equals, finalize, getClass, hashCode, notify, notifyAll, wait, wait, wait
-
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
-
-
-
-
字段详细信息
-
LOAD
public static final int LOAD
该常量值表示文件对话窗口的目的是找到要从中读取的文件。- 另请参见:
- Constant Field Values
-
SAVE
public static final int SAVE
该常量值表示文件对话窗口的目的是找到要写入的文件。- 另请参见:
- Constant Field Values
-
-
构造方法详细信息
-
FileDialog
public FileDialog(Frame parent)
创建一个加载文件的文件对话框。 文件对话框的标题最初为空。 这是一个方便的方法FileDialog(parent, "", LOAD)
。注意:某些平台可能不支持在文件对话框中显示用户指定的标题。 在这种情况下,文件对话框的标题栏中不会显示任何标题,或者在某些系统上将不会显示文件对话框的标题栏。
- 参数
-
parent
- 对话框的所有者 - 从以下版本开始:
- 1.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
时,总是会抛出此异常 - 从以下版本开始:
- 1.5
- 另请参见:
-
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
时,始终抛出此异常 - 从以下版本开始:
- 1.5
- 另请参见:
-
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
时,总是抛出此异常 - 从以下版本开始:
- 1.5
- 另请参见:
-
GraphicsEnvironment.isHeadless()
,LOAD
,SAVE
-
-
方法详细信息
-
setTitle
public void setTitle(String title)
设置对话框的标题。注意:某些平台可能不支持在文件对话框中显示用户指定的标题。 在这种情况下,文件对话框的标题栏中不会显示任何标题,或者在某些系统上将不会显示文件对话框的标题栏。
- 重写:
-
setTitle
在Dialog
- 参数
-
title
- 对话框边框中显示的标题; 空值导致空标题 - 另请参见:
-
Dialog.getTitle()
-
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
。- 参数
-
mode
- 此文件对话框的模式,FileDialog.LOAD
或FileDialog.SAVE
- 异常
-
IllegalArgumentException
- 如果提供非法文件对话模式 - 从以下版本开始:
- 1.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()
返回用户选择的文件。如果用户取消文件对话框,则该方法返回一个空数组。
- 结果
- 如果用户取消文件对话框,用户选择的文件或空数组。
- 从以下版本开始:
- 1.7
- 另请参见:
-
setFile(String)
,getFile()
-
setFile
public void setFile(String file)
将此文件对话框窗口的选定文件设置为指定的文件。 如果在首次显示文件对话窗口之前设置该文件,该文件将成为默认文件。当显示对话框时,选择指定的文件。 选择的种类取决于文件的存在,对话框类型和本地平台。 例如,该文件可以在文件列表中突出显示,或者文件名编辑框可以用文件名填充。
如果与
setDirectory
方法一起使用,则此方法接受完整文件路径或具有扩展名的文件名。指定“”作为文件完全等同于指定
null
作为文件。- 参数
-
file
- 正在设置的文件 - 另请参见:
-
getFile()
,getFiles()
-
setMultipleMode
public void setMultipleMode(boolean enable)
启用或禁用文件对话框的多个文件选择。- 参数
-
enable
- 如果true
,启用多个文件选择;false
- 禁用。 - 从以下版本开始:
- 1.7
- 另请参见:
-
isMultipleMode()
-
isMultipleMode
public boolean isMultipleMode()
返回文件对话框是否允许多个文件选择。- 结果
-
true
如果文件对话框允许多个文件选择; 否则为false
。 - 从以下版本开始:
- 1.7
- 另请参见:
-
setMultipleMode(boolean)
-
getFilenameFilter
public FilenameFilter getFilenameFilter()
确定此文件对话框的文件名过滤器。 文件名过滤器允许用户指定文件对话窗口中显示哪些文件。 文件名过滤器在Sun的Microsoft Windows参考实现中不起作用。- 结果
- 此文件对话框的文件名过滤器
- 另请参见:
-
FilenameFilter
,setFilenameFilter(java.io.FilenameFilter)
-
setFilenameFilter
public void setFilenameFilter(FilenameFilter filter)
将此文件对话窗口的文件名过滤器设置为指定的过滤器。 文件名过滤器在Sun的Microsoft Windows参考实现中不起作用。- 参数
-
filter
- 指定的过滤器 - 另请参见:
-
FilenameFilter
,getFilenameFilter()
-
paramString
protected String paramString()
返回一个表示FileDialog
窗口状态的字符串。 该方法仅用于调试目的,并且返回的字符串的内容和格式可能因实现而异。 返回的字符串可能为空,但可能不是null
。- 重写:
-
paramString
在Dialog
- 结果
- 该文件对话窗口的参数字符串
-
-