文件对话框
概述
文件对话框(FileDialog)用于选择文件系统中的文件或目录的对话框,类似于一个Windows资源管理器,不同的这个文件管理窗口是通过IdeaXR中的UI控件实现的。
另请参阅弹窗,其中包含与此节点关联的通用属性和方法。
节点使用
属性
文件对话框的常用属性如下:
模式覆盖标题:当文件对话框的“模式”属性发生变化时,对话框上的一些文本也会改变。禁用此属性后,文本将不会再随模式改变。
模式:文件对话框选择文件的模式:
- 打开文件 --- 该对话框只允许选择一个文件。
- Open Files--- 该对话框允许选择多个文件。
- Open Folder --- 该对话框只允许选择一个目录,不允许选择任何文件。
- Open Any --- 该对话框允许选择一个文件或目录。
- 保存 --- 当文件存在时,对话框会发出警告。
访问:文件系统的访问范围
- 资源 --- 该对话框只允许访问Resource路径下的文件(
res://
)。 - User Data --- 该对话框只允许访问用户数据路径(
user://
)下的文件。 - File system --- 该对话框允许访问文件系统上的文件。
- 资源 --- 该对话框只允许访问Resource路径下的文件(
过滤器:文件对话框内显示的文件类型。例如:以下设置将只显示
.png
和.is
文件当前目录:文件对话框当前的显示的目录
当前文件:文件对话框当前选择的文件名称
当前路径:文件对话框当前选择的文件路径
信号
- dir_selected ( String dir )
当用户选择一个目录时触发,参数为所选的目录。
- file_selected ( String path )
当用户通过双击文件或按确定按钮选择一个文件时触发,参数为所选的文件路径。
- files_selected ( PoolStringArray paths )
当用户选择多个文件时触发,参数为所选文件路径的字符串数组。