b68dd2e189
This makes it easier to spot syntax errors when editing the class reference. The schema is referenced locally so validation can still work offline. Each class XML's schema conformance is also checked on GitHub Actions.
162 lines
8.1 KiB
XML
162 lines
8.1 KiB
XML
<?xml version="1.0" encoding="UTF-8" ?>
|
|
<class name="FileDialog" inherits="ConfirmationDialog" version="4.0" xmlns:xsi="http://www.w3.org/2001/XMLSchema-instance" xsi:noNamespaceSchemaLocation="../class.xsd">
|
|
<brief_description>
|
|
Dialog for selecting files or directories in the filesystem.
|
|
</brief_description>
|
|
<description>
|
|
FileDialog is a preset dialog used to choose files and directories in the filesystem. It supports filter masks. The FileDialog automatically sets its window title according to the [member file_mode]. If you want to use a custom title, disable this by setting [member mode_overrides_title] to [code]false[/code].
|
|
</description>
|
|
<tutorials>
|
|
</tutorials>
|
|
<methods>
|
|
<method name="add_filter">
|
|
<return type="void" />
|
|
<argument index="0" name="filter" type="String" />
|
|
<description>
|
|
Adds [code]filter[/code] to the list of filters, which restricts what files can be picked.
|
|
A [code]filter[/code] should be of the form [code]"filename.extension ; Description"[/code], where filename and extension can be [code]*[/code] to match any string. Filters starting with [code].[/code] (i.e. empty filenames) are not allowed.
|
|
Example filters: [code]"*.png ; PNG Images"[/code], [code]"project.godot ; Godot Project"[/code].
|
|
</description>
|
|
</method>
|
|
<method name="clear_filters">
|
|
<return type="void" />
|
|
<description>
|
|
Clear all the added filters in the dialog.
|
|
</description>
|
|
</method>
|
|
<method name="deselect_all">
|
|
<return type="void" />
|
|
<description>
|
|
Clear all currently selected items in the dialog.
|
|
</description>
|
|
</method>
|
|
<method name="get_line_edit">
|
|
<return type="LineEdit" />
|
|
<description>
|
|
Returns the LineEdit for the selected file.
|
|
[b]Warning:[/b] This is a required internal node, removing and freeing it may cause a crash. If you wish to hide it or any of its children, use their [member CanvasItem.visible] property.
|
|
</description>
|
|
</method>
|
|
<method name="get_vbox">
|
|
<return type="VBoxContainer" />
|
|
<description>
|
|
Returns the vertical box container of the dialog, custom controls can be added to it.
|
|
[b]Warning:[/b] This is a required internal node, removing and freeing it may cause a crash. If you wish to hide it or any of its children, use their [member CanvasItem.visible] property.
|
|
</description>
|
|
</method>
|
|
<method name="invalidate">
|
|
<return type="void" />
|
|
<description>
|
|
Invalidate and update the current dialog content list.
|
|
</description>
|
|
</method>
|
|
</methods>
|
|
<members>
|
|
<member name="access" type="int" setter="set_access" getter="get_access" enum="FileDialog.Access" default="0">
|
|
The file system access scope. See enum [code]Access[/code] constants.
|
|
[b]Warning:[/b] Currently, in sandboxed environments such as HTML5 builds or sandboxed macOS apps, FileDialog cannot access the host file system. See [url=https://github.com/godotengine/godot-proposals/issues/1123]godot-proposals#1123[/url].
|
|
</member>
|
|
<member name="current_dir" type="String" setter="set_current_dir" getter="get_current_dir" default=""res://"">
|
|
The current working directory of the file dialog.
|
|
</member>
|
|
<member name="current_file" type="String" setter="set_current_file" getter="get_current_file" default="""">
|
|
The currently selected file of the file dialog.
|
|
</member>
|
|
<member name="current_path" type="String" setter="set_current_path" getter="get_current_path" default=""res://"">
|
|
The currently selected file path of the file dialog.
|
|
</member>
|
|
<member name="dialog_hide_on_ok" type="bool" setter="set_hide_on_ok" getter="get_hide_on_ok" overrides="AcceptDialog" default="false" />
|
|
<member name="file_mode" type="int" setter="set_file_mode" getter="get_file_mode" enum="FileDialog.FileMode" default="4">
|
|
The dialog's open or save mode, which affects the selection behavior. See [enum FileMode].
|
|
</member>
|
|
<member name="filters" type="PackedStringArray" setter="set_filters" getter="get_filters" default="PackedStringArray()">
|
|
The available file type filters. For example, this shows only [code].png[/code] and [code].gd[/code] files: [code]set_filters(PackedStringArray(["*.png ; PNG Images","*.gd ; GDScript Files"]))[/code]. Multiple file types can also be specified in a single filter. [code]"*.png, *.jpg, *.jpeg ; Supported Images"[/code] will show both PNG and JPEG files when selected.
|
|
</member>
|
|
<member name="mode_overrides_title" type="bool" setter="set_mode_overrides_title" getter="is_mode_overriding_title" default="true">
|
|
If [code]true[/code], changing the [code]Mode[/code] property will set the window title accordingly (e.g. setting mode to [constant FILE_MODE_OPEN_FILE] will change the window title to "Open a File").
|
|
</member>
|
|
<member name="show_hidden_files" type="bool" setter="set_show_hidden_files" getter="is_showing_hidden_files" default="false">
|
|
If [code]true[/code], the dialog will show hidden files.
|
|
</member>
|
|
<member name="title" type="String" setter="set_title" getter="get_title" overrides="Window" default=""Save a File"" />
|
|
</members>
|
|
<signals>
|
|
<signal name="dir_selected">
|
|
<argument index="0" name="dir" type="String" />
|
|
<description>
|
|
Emitted when the user selects a directory.
|
|
</description>
|
|
</signal>
|
|
<signal name="file_selected">
|
|
<argument index="0" name="path" type="String" />
|
|
<description>
|
|
Emitted when the user selects a file by double-clicking it or pressing the [b]OK[/b] button.
|
|
</description>
|
|
</signal>
|
|
<signal name="files_selected">
|
|
<argument index="0" name="paths" type="PackedStringArray" />
|
|
<description>
|
|
Emitted when the user selects multiple files.
|
|
</description>
|
|
</signal>
|
|
</signals>
|
|
<constants>
|
|
<constant name="FILE_MODE_OPEN_FILE" value="0" enum="FileMode">
|
|
The dialog allows selecting one, and only one file.
|
|
</constant>
|
|
<constant name="FILE_MODE_OPEN_FILES" value="1" enum="FileMode">
|
|
The dialog allows selecting multiple files.
|
|
</constant>
|
|
<constant name="FILE_MODE_OPEN_DIR" value="2" enum="FileMode">
|
|
The dialog only allows selecting a directory, disallowing the selection of any file.
|
|
</constant>
|
|
<constant name="FILE_MODE_OPEN_ANY" value="3" enum="FileMode">
|
|
The dialog allows selecting one file or directory.
|
|
</constant>
|
|
<constant name="FILE_MODE_SAVE_FILE" value="4" enum="FileMode">
|
|
The dialog will warn when a file exists.
|
|
</constant>
|
|
<constant name="ACCESS_RESOURCES" value="0" enum="Access">
|
|
The dialog only allows accessing files under the [Resource] path ([code]res://[/code]).
|
|
</constant>
|
|
<constant name="ACCESS_USERDATA" value="1" enum="Access">
|
|
The dialog only allows accessing files under user data path ([code]user://[/code]).
|
|
</constant>
|
|
<constant name="ACCESS_FILESYSTEM" value="2" enum="Access">
|
|
The dialog allows accessing files on the whole file system.
|
|
</constant>
|
|
</constants>
|
|
<theme_items>
|
|
<theme_item name="file_icon_modulate" data_type="color" type="Color" default="Color(1, 1, 1, 1)">
|
|
The color modulation applied to the file icon.
|
|
</theme_item>
|
|
<theme_item name="files_disabled" data_type="color" type="Color" default="Color(0, 0, 0, 0.7)">
|
|
The color tint for disabled files (when the [FileDialog] is used in open folder mode).
|
|
</theme_item>
|
|
<theme_item name="folder_icon_modulate" data_type="color" type="Color" default="Color(1, 1, 1, 1)">
|
|
The color modulation applied to the folder icon.
|
|
</theme_item>
|
|
<theme_item name="back_folder" data_type="icon" type="Texture2D">
|
|
Custom icon for the back arrow.
|
|
</theme_item>
|
|
<theme_item name="file" data_type="icon" type="Texture2D">
|
|
Custom icon for files.
|
|
</theme_item>
|
|
<theme_item name="folder" data_type="icon" type="Texture2D">
|
|
Custom icon for folders.
|
|
</theme_item>
|
|
<theme_item name="forward_folder" data_type="icon" type="Texture2D">
|
|
Custom icon for the forward arrow.
|
|
</theme_item>
|
|
<theme_item name="parent_folder" data_type="icon" type="Texture2D">
|
|
Custom icon for the parent folder arrow.
|
|
</theme_item>
|
|
<theme_item name="reload" data_type="icon" type="Texture2D">
|
|
Custom icon for the reload button.
|
|
</theme_item>
|
|
<theme_item name="toggle_hidden" data_type="icon" type="Texture2D">
|
|
Custom icon for the toggle hidden button.
|
|
</theme_item>
|
|
</theme_items>
|
|
</class>
|