Module  java.desktop
软件包  java.awt

Class FileDialog

  • All Implemented Interfaces:
    ImageObserver ， MenuContainer ， Serializable ， Accessible 

    public class FileDialog
extends Dialog
    FileDialog类显示一个对话窗口，用户可以从中选择一个文件。

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

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

    • 字段详细信息

      • LOAD

        public static final int LOAD
        该常量值表示文件对话窗口的目的是找到要从中读取的文件。
        另请参见：
        Constant Field Values

      • SAVE

        public static final int SAVE
        该常量值表示文件对话窗口的目的是找到要写入的文件。
        另请参见：
        Constant Field Values

    • 构造方法详细信息

      • 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 - 对话框边框中显示的标题; 空值导致空标题
        另请参见：
        Dialog.getTitle()

      • getMode

        public int getMode​()
        指示此文件对话框是从文件加载还是保存到文件。
        结果
        该文件对话窗口的模式，可以是 FileDialog.LOAD或 FileDialog.SAVE
        另请参见：
        LOAD ， SAVE ， setMode(int)

      • setMode

        public void setMode​(int mode)
        设置文件对话框的模式。 如果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
        结果
        该文件对话窗口的参数字符串