Module java.desktop
Package java.awt

Class 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方法显示对话框时，它会阻塞应用程序的其余部分，直到用户选择了一个文件。

自：
1.0
参见：

  • Field Details

    • LOAD

      public static final int LOAD
      此常量值表示文件对话框窗口的目的是定位要读取的文件。
      参见：

    • SAVE

      public static final int SAVE
      此常量值表示文件对话框窗口的目的是定位要写入的文件。
      参见：

  • Constructor Details

    • 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 - 如果提供了非法的文件对话框模式
      参见：

    • FileDialog

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

      注意：某些平台可能不支持在文件对话框中显示用户指定的标题。在这种情况下，要么在文件对话框的标题栏中不显示标题，要么在某些系统上，文件对话框的标题栏将不会显示。

      参数：
      parent - 对话框的所有者
      抛出：
      IllegalArgumentException - 如果parent的GraphicsConfiguration不是来自屏幕设备；
      IllegalArgumentException - 如果parent为null；当GraphicsEnvironment.isHeadless返回true时，总是抛出此异常
      自：
      1.5
      参见：

    • 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
      参见：

    • 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
      参见：

  • Method Details

    • setTitle

      public void setTitle(String title)
      设置对话框的标题。

      注意：某些平台可能不支持在文件对话框中显示用户指定的标题。在这种情况下，要么在文件对话框的标题栏中不显示任何标题，要么在某些系统上，文件对话框的标题栏将不会显示。

      覆盖：
      setTitle 在类 Dialog
      参数：
      title - 对话框边框中显示的标题；空值将导致空标题
      另请参阅：

    • addNotify

      public void addNotify()
      创建文件对话框的对等体。对等体允许我们更改文件对话框的外观，而不更改其功能。
      覆盖：
      addNotify 在类 Dialog
      另请参阅：

    • getMode

      public int getMode()
      指示此文件对话框是用于从文件加载还是保存到文件。
      返回：
      此文件对话框窗口的模式，可以是FileDialog.LOAD或FileDialog.SAVE
      另请参阅：

    • setMode

      public void setMode(int mode)
      设置文件对话框的模式。如果mode不是合法值，则会抛出异常，并且不会设置mode。
      参数：
      mode - 此文件对话框的模式，可以是FileDialog.LOAD或FileDialog.SAVE
      抛出：
      IllegalArgumentException - 如果提供了非法的文件对话框模式
      自：
      1.1
      另请参阅：

    • getDirectory

      public String getDirectory()
      获取此文件对话框的目录。
      返回：
      此FileDialog的（可能为null或无效的）目录
      另请参阅：

    • setDirectory

      public void setDirectory(String dir)
      将此文件对话框窗口的目录设置为指定目录。指定null或无效目录意味着一个实现定义的默认目录。但是，直到用户选择文件之前，此默认值不会实现。在此之前，getDirectory()将返回传递给此方法的值。

      将""指定为目录与将null指定为目录完全等效。

      参数：
      dir - 指定的目录
      另请参阅：

    • getFile

      public String getFile()
      获取此文件对话框的所选文件。如果用户选择了CANCEL，则返回的文件为null。
      返回：
      此文件对话框窗口当前选择的文件，如果没有选择任何文件，则为null
      另请参阅：

    • getFiles

      public File[] getFiles()
      返回用户选择的文件。

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

      返回：
      用户选择的文件或如果用户取消文件对话框则返回一个空数组。
      自：
      1.7
      另请参阅：

    • setFile

      public void setFile(String file)
      将此文件对话框窗口的所选文件设置为指定文件。如果在首次显示文件对话框窗口之前设置了此文件，则此文件将成为默认文件。

      显示对话框时，将选择指定的文件。选择的方式取决于文件的存在性、对话框类型和本机平台。例如，文件可能会在文件列表中突出显示，或者文件名编辑框可能会填充文件名。

      此方法接受完整文件路径或者与setDirectory方法一起使用时带有扩展名的文件名。

      将""指定为文件与将null指定为文件完全等效。

      参数：
      file - 要设置的文件
      另请参阅：

    • setMultipleMode

      public void setMultipleMode(boolean enable)
      启用或禁用文件对话框的多文件选择。
      参数：
      enable - 如果为true，则启用多文件选择；false - 禁用。
      自：
      1.7
      另请参阅：

    • isMultipleMode

      public boolean isMultipleMode()
      返回文件对话框是否允许多文件选择。
      返回：
      如果文件对话框允许多文件选择，则为true；否则为false。
      自：
      1.7
      另请参阅：

    • getFilenameFilter

      public FilenameFilter getFilenameFilter()
      确定此文件对话框的文件名过滤器。文件名过滤器允许用户指定在文件对话框窗口中显示哪些文件。在Sun的参考实现中，文件名过滤器不起作用于Microsoft Windows。
      返回：
      此文件对话框的文件名过滤器
      另请参阅：

    • setFilenameFilter

      public void setFilenameFilter(FilenameFilter filter)
      将此文件对话框窗口的文件名过滤器设置为指定的过滤器。在Sun的参考实现中，文件名过滤器不起作用于Microsoft Windows。
      参数：
      filter - 指定的过滤器
      另请参阅：

    • paramString

      protected String paramString()
      返回表示此FileDialog窗口状态的字符串。此方法仅用于调试目的，返回的字符串的内容和格式可能因实现而异。返回的字符串可能为空，但不能为null。
      覆盖：
      paramString 在类 Dialog
      返回：
      此文件对话框窗口的参数字符串