java.awt
類別 FileDialog

java.lang.Object
  java.awt.Component
      java.awt.Container
          java.awt.Window
              java.awt.Dialog
                  java.awt.FileDialog

所有已實作的介面：

ImageObserver, MenuContainer, Serializable, Accessible

public class FileDialog
extends Dialog

FileDialog 類別顯示一個對話框視窗，使用者可以從中選擇檔案。

由於它是一個網要對話框，當應用程序調用其 show 方法來顯示對話框時，它將阻塞其餘應用程序，直到使用者選擇一個檔案。

從以下版本開始：

JDK1.0

另請參見：

Window.show(), 序列化表格

巢狀類別摘要

從類別 java.awt.Dialog 繼承的巢狀類別/介面

Dialog.AccessibleAWTDialog, Dialog.ModalExclusionType, Dialog.ModalityType

從類別 java.awt.Window 繼承的巢狀類別/介面

Window.AccessibleAWTWindow

從類別 java.awt.Container 繼承的巢狀類別/介面

Container.AccessibleAWTContainer

從類別 java.awt.Component 繼承的巢狀類別/介面

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

欄位摘要

static int	LOAD 此常數值指示檔案對話框視窗的作用是尋找要讀取的檔案。
static int	SAVE 此常數值指示檔案對話框視窗的作用是尋找要寫入的檔案。

從類別 java.awt.Dialog 繼承的欄位

DEFAULT_MODALITY_TYPE

從類別 java.awt.Component 繼承的欄位

BOTTOM_ALIGNMENT, CENTER_ALIGNMENT, LEFT_ALIGNMENT, RIGHT_ALIGNMENT, TOP_ALIGNMENT

從介面 java.awt.image.ImageObserver 繼承的欄位

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

建構子摘要

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)
創建一個具有指定標題的檔案對話框視窗，用於載入或保存檔案。

方法摘要

void	addNotify() 創建檔案對話框的同位體。
String	getDirectory() 獲取此檔案對話框的目錄。
String	getFile() 獲取此檔案對話框的選定檔案。
FilenameFilter	getFilenameFilter() 確定此檔案對話框的檔案名過濾器。
int	getMode() 指示此檔案對話框是用於從檔案載入內容還是將內容保存到檔案。
protected String	paramString() 返回表示此 FileDialog 視窗狀態的字元串。
void	setDirectory(String dir) 將此檔案對話框視窗的目錄設置為指定目錄。
void	setFile(String file) 將此檔案對話框視窗的選定檔案設置為指定檔案。
void	setFilenameFilter(FilenameFilter filter) 將此檔案對話框視窗的檔案名過濾器設置為指定的過濾器。
void	setMode(int mode) 設置檔案對話框的網要。

從類別 java.awt.Dialog 繼承的方法

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

從類別 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

從類別 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

從類別 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

從類別 java.lang.Object 繼承的方法

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

欄位詳細資訊

LOAD

public static final int LOAD

此常數值指示檔案對話框視窗的作用是尋找要讀取的檔案。

另請參見：

常數欄位值

SAVE

public static final int SAVE

此常數值指示檔案對話框視窗的作用是尋找要寫入的檔案。

另請參見：

常數欄位值

建構子詳細資訊

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 時始終拋出此異常

從以下版本開始：

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

方法詳細資訊

addNotify

public void addNotify()

創建檔案對話框的同位體。同位體允許我們更改檔案對話框的外觀而不更改其功能。

覆寫：

類別 Dialog 中的 addNotify

另請參見：

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()

獲取此檔案對話框的目錄。

返回：

此 FileDialog 的目錄（可能為 null 或無效）

另請參見：

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)

setFile

public void setFile(String file)

將此檔案對話框視窗的選定檔案設置為指定檔案。如果這麼設置，那麼在檔案對話框視窗第一次顯示之前，此檔案就成為預設檔案。

指定 "" 作為檔案，完全等同於指定 null 作為檔案。

參數：

file - 正被設置的檔案 set

另請參見：

getFile()

getFilenameFilter

public FilenameFilter getFilenameFilter()

確定此檔案對話框的檔案名過濾器。檔案名過濾器允許使用者指定哪個檔案出現在檔案對話框視窗。Microsoft Windows 的檔案名過濾器在 Sun 的參考實作中不起作用。

返回：

此檔案對話框的檔案名過濾器

另請參見：

FilenameFilter, setFilenameFilter(java.io.FilenameFilter)

setFilenameFilter

public void setFilenameFilter(FilenameFilter filter)

將此檔案對話框視窗的檔案名過濾器設置為指定的過濾器。Microsoft Windows 的檔案名過濾器在 Sun 的參考實作中不起作用。

參數：

filter - 指定的過濾器

另請參見：

FilenameFilter, getFilenameFilter()

paramString

protected String paramString()

返回表示此 FileDialog 視窗狀態的字元串。此方法僅在進行除錯的時候使用，對於不同的實作，返回的字元串的內容和格式可能有所不同。返回的字元串可能為空，但不可能為 null。

覆寫：

類別 Dialog 中的 paramString

返回：

此檔案對話框視窗的參數字元串