模块  java.desktop
软件包  java.awt

Class FileDialog

  • 实现的所有接口
    ImageObserver ， MenuContainer ， Serializable ， Accessible 
    public class FileDialogextends Dialog
    FileDialog类显示一个对话窗口，用户可以从中选择文件。

    由于它是一个模态对话框，当应用程序调用其show方法来显示对话框时，它会阻止应用程序的其余部分，直到用户选择了一个文件。

    从以下版本开始：
    1.0
    另请参见：
    Window.show() ， Serialized Form

    • 字段详细信息

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

      • 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
        结果
        此文件对话框窗口的参数字符串