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

自从：
1.0
参见：

  • 字段详细信息

    • LOAD

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

    • SAVE

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

  • 构造方法详细信息

    • FileDialog

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

      Note: 某些平台可能不支持在文件对话框中显示用户指定的标题。在这种情况下，文件对话框的标题栏中不会显示任何标题，或者在某些系统上，文件对话框的标题栏不会显示。

      参数：
      parent - 对话框的所有者
      自从：
      1.1

    • FileDialog

      public FileDialog(Frame  parent, String  title)
      创建具有指定标题的文件对话框窗口以加载文件。显示的文件是当前目录中的文件。这是 FileDialog(parent, title, LOAD) 的便捷方法。

      Note: 某些平台可能不支持在文件对话框中显示用户指定的标题。在这种情况下，文件对话框的标题栏中不会显示任何标题，或者在某些系统上，文件对话框的标题栏不会显示。

      参数：
      parent - 对话框的所有者
      title - 对话框的标题

    • FileDialog

      public FileDialog(Frame  parent, String  title, int mode)
      创建一个具有指定标题的文件对话窗口，用于加载或保存文件。

      如果 mode 的值为 LOAD ，则文件对话框正在查找要读取的文件，并且显示的文件是当前目录中的文件。如果 mode 的值为 SAVE ，则文件对话框正在寻找写入文件的位置。

      Note: 某些平台可能不支持在文件对话框中显示用户指定的标题。在这种情况下，文件对话框的标题栏中不会显示任何标题，或者在某些系统上，文件对话框的标题栏不会显示。

      参数：
      parent - 对话框的所有者
      title - 对话框的标题
      mode - 对话框的模式； FileDialog.LOAD 或 FileDialog.SAVE
      抛出：
      IllegalArgumentException - 如果提供了非法文件对话框模式
      参见：

    • FileDialog

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

      Note: 某些平台可能不支持在文件对话框中显示用户指定的标题。在这种情况下，文件对话框的标题栏中不会显示任何标题，或者在某些系统上，文件对话框的标题栏不会显示。

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

    • FileDialog

      public FileDialog(Dialog  parent, String  title)
      创建具有指定标题的文件对话框窗口以加载文件。显示的文件是当前目录中的文件。这是 FileDialog(parent, title, LOAD) 的便捷方法。

      Note: 某些平台可能不支持在文件对话框中显示用户指定的标题。在这种情况下，文件对话框的标题栏中不会显示任何标题，或者在某些系统上，文件对话框的标题栏不会显示。

      参数：
      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 ，则文件对话框正在寻找写入文件的位置。

      Note: 某些平台可能不支持在文件对话框中显示用户指定的标题。在这种情况下，文件对话框的标题栏中不会显示任何标题，或者在某些系统上，文件对话框的标题栏不会显示。

      参数：
      parent - 对话框的所有者
      title - 对话框的标题； null 值将被接受而不会导致抛出 NullPointerException
      mode - 对话框的模式； FileDialog.LOAD 或 FileDialog.SAVE
      抛出：
      IllegalArgumentException - 如果提供了非法文件对话框模式；
      IllegalArgumentException - 如果 parent 的 GraphicsConfiguration 不是来自屏幕设备；
      IllegalArgumentException - 如果 parent 是 null ；当 GraphicsEnvironment.isHeadless 返回 true 时总是抛出这个异常
      自从：
      1.5
      参见：

  • 方法详情

    • setTitle

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

      Note: 某些平台可能不支持在文件对话框中显示用户指定的标题。在这种情况下，文件对话框的标题栏中不会显示任何标题，或者在某些系统上，文件对话框的标题栏不会显示。

      重写：
      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 中
      返回：
      此文件对话框窗口的参数字符串