Module  java.desktop
软件包  java.awt

Class FileDialog

  • All Implemented Interfaces:
    ImageObserverMenuContainerSerializableAccessible


    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.LOADFileDialog.SAVE
        异常
        IllegalArgumentException - 如果提供非法文件对话模式
        另请参见:
        LOADSAVE
      • FileDialog

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

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

        参数
        parent - 对话框的所有者
        异常
        IllegalArgumentException - 如果 parentGraphicsConfiguration不是从屏幕设备;
        IllegalArgumentException - 如果parentnull ; GraphicsEnvironment.isHeadless返回true时,总是会抛出此异常
        从以下版本开始:
        1.5
        另请参见:
        GraphicsEnvironment.isHeadless()
      • FileDialog

        public FileDialog​(Dialog parent,
                          String title)
        创建一个文件对话框窗口,其中包含用于加载文件的指定标题。 显示的文件是当前目录中的文件。 这是一个方便的方法FileDialog(parent, title, LOAD)

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

        参数
        parent - 对话框的所有者
        title - 对话框的标题; 一个null值将被接受,而不会引起NullPointerException
        异常
        IllegalArgumentException - 如果 parentGraphicsConfiguration不是从屏幕设备;
        IllegalArgumentException - 如果parentnull ; 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.LOADFileDialog.SAVE
        异常
        IllegalArgumentException - 如果提供非法文件对话模式;
        IllegalArgumentException - 如果 parentGraphicsConfiguration不是来自屏幕设备;
        IllegalArgumentException - 如果parentnull ; GraphicsEnvironment.isHeadless返回true时,总是抛出此异常
        从以下版本开始:
        1.5
        另请参见:
        GraphicsEnvironment.isHeadless()LOADSAVE
    • 方法详细信息

      • setTitle

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

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

        重写:
        setTitleDialog
        参数
        title - 对话框边框中显示的标题; 空值导致空标题
        另请参见:
        Dialog.getTitle()
      • getMode

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

        public void setMode​(int mode)
        设置文件对话框的模式。 如果mode不是合法值,将抛出异常, mode将不会设置mode
        参数
        mode - 此文件对话框的模式, FileDialog.LOADFileDialog.SAVE
        异常
        IllegalArgumentException - 如果提供非法文件对话模式
        从以下版本开始:
        1.1
        另请参见:
        LOADSAVEgetMode()
      • 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参考实现中不起作用。
        结果
        此文件对话框的文件名过滤器
        另请参见:
        FilenameFiltersetFilenameFilter(java.io.FilenameFilter)
      • setFilenameFilter

        public void setFilenameFilter​(FilenameFilter filter)
        将此文件对话窗口的文件名过滤器设置为指定的过滤器。 文件名过滤器在Sun的Microsoft Windows参考实现中不起作用。
        参数
        filter - 指定的过滤器
        另请参见:
        FilenameFiltergetFilenameFilter()
      • paramString

        protected String paramString​()
        返回一个表示FileDialog窗口状态的字符串。 该方法仅用于调试目的,并且返回的字符串的内容和格式可能因实现而异。 返回的字符串可能为空,但可能不是null
        重写:
        paramStringDialog
        结果
        该文件对话窗口的参数字符串