跳到主要内容

文件对话框

概述

文件对话框(FileDialog)用于选择文件系统中的文件或目录的对话框,类似于一个Windows资源管理器,不同的这个文件管理窗口是通过IdeaXR中的UI控件实现的。

另请参阅弹窗,其中包含与此节点关联的通用属性和方法。

节点使用

属性

文件对话框的常用属性如下:

  • 模式覆盖标题:当文件对话框的“模式”属性发生变化时,对话框上的一些文本也会改变。禁用此属性后,文本将不会再随模式改变。

  • 模式:文件对话框选择文件的模式:

    • 打开文件 --- 该对话框只允许选择一个文件。
    • Open Files--- 该对话框允许选择多个文件。
    • Open Folder --- 该对话框只允许选择一个目录,不允许选择任何文件。
    • Open Any --- 该对话框允许选择一个文件或目录。
    • 保存 --- 当文件存在时,对话框会发出警告。
  • 访问:文件系统的访问范围

    • 资源 --- 该对话框只允许访问Resource路径下的文件(res://)。
    • User Data --- 该对话框只允许访问用户数据路径(user://)下的文件。
    • File system --- 该对话框允许访问文件系统上的文件。
  • 过滤器:文件对话框内显示的文件类型。例如:以下设置将只显示.png.is文件

  • 当前目录:文件对话框当前的显示的目录

  • 当前文件:文件对话框当前选择的文件名称

  • 当前路径:文件对话框当前选择的文件路径

信号

当用户选择一个目录时触发,参数为所选的目录。

当用户通过双击文件或按确定按钮选择一个文件时触发,参数为所选的文件路径。

当用户选择多个文件时触发,参数为所选文件路径的字符串数组。