字段详细信息

• LOAD

  public static final int LOAD

  此常量值表示文件对话框窗口的目的是查找要从中读取的文件。

  另请参见：

  常数字段值

• SAVE

  public static final int SAVE

  此常量值表示文件对话框窗口的目的是查找要写入的文件。

  另请参见：

  常数字段值

构造方法详细信息

• 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 - 对话框边框中显示的标题; null值导致空标题

  另请参见：

  Dialog.getTitle()

• addNotify

  public void addNotify()

  创建文件对话框的对等方。 对等体允许我们在不改变其功能的情况下更改文件对话框的外观。

  重写：

  addNotify类 Dialog

  另请参见：

  Component.isDisplayable() ， Container.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 - 如果提供了非法文件对话框模式

  从以下版本开始：

  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

  结果

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