2023-01-05 13:25:55 +01:00
|
|
|
/**************************************************************************/
|
|
|
|
/* file_dialog.h */
|
|
|
|
/**************************************************************************/
|
|
|
|
/* This file is part of: */
|
|
|
|
/* GODOT ENGINE */
|
|
|
|
/* https://godotengine.org */
|
|
|
|
/**************************************************************************/
|
|
|
|
/* Copyright (c) 2014-present Godot Engine contributors (see AUTHORS.md). */
|
|
|
|
/* Copyright (c) 2007-2014 Juan Linietsky, Ariel Manzur. */
|
|
|
|
/* */
|
|
|
|
/* Permission is hereby granted, free of charge, to any person obtaining */
|
|
|
|
/* a copy of this software and associated documentation files (the */
|
|
|
|
/* "Software"), to deal in the Software without restriction, including */
|
|
|
|
/* without limitation the rights to use, copy, modify, merge, publish, */
|
|
|
|
/* distribute, sublicense, and/or sell copies of the Software, and to */
|
|
|
|
/* permit persons to whom the Software is furnished to do so, subject to */
|
|
|
|
/* the following conditions: */
|
|
|
|
/* */
|
|
|
|
/* The above copyright notice and this permission notice shall be */
|
|
|
|
/* included in all copies or substantial portions of the Software. */
|
|
|
|
/* */
|
|
|
|
/* THE SOFTWARE IS PROVIDED "AS IS", WITHOUT WARRANTY OF ANY KIND, */
|
|
|
|
/* EXPRESS OR IMPLIED, INCLUDING BUT NOT LIMITED TO THE WARRANTIES OF */
|
|
|
|
/* MERCHANTABILITY, FITNESS FOR A PARTICULAR PURPOSE AND NONINFRINGEMENT. */
|
|
|
|
/* IN NO EVENT SHALL THE AUTHORS OR COPYRIGHT HOLDERS BE LIABLE FOR ANY */
|
|
|
|
/* CLAIM, DAMAGES OR OTHER LIABILITY, WHETHER IN AN ACTION OF CONTRACT, */
|
|
|
|
/* TORT OR OTHERWISE, ARISING FROM, OUT OF OR IN CONNECTION WITH THE */
|
|
|
|
/* SOFTWARE OR THE USE OR OTHER DEALINGS IN THE SOFTWARE. */
|
|
|
|
/**************************************************************************/
|
2018-01-05 00:50:27 +01:00
|
|
|
|
2014-02-10 02:10:30 +01:00
|
|
|
#ifndef FILE_DIALOG_H
|
|
|
|
#define FILE_DIALOG_H
|
|
|
|
|
2017-03-05 16:44:50 +01:00
|
|
|
#include "box_container.h"
|
2021-06-11 14:51:48 +02:00
|
|
|
#include "core/io/dir_access.h"
|
2017-03-05 16:44:50 +01:00
|
|
|
#include "scene/gui/dialogs.h"
|
2014-02-10 02:10:30 +01:00
|
|
|
#include "scene/gui/line_edit.h"
|
|
|
|
#include "scene/gui/option_button.h"
|
2017-03-05 16:44:50 +01:00
|
|
|
#include "scene/gui/tree.h"
|
2019-08-10 14:28:17 +02:00
|
|
|
|
2023-10-13 11:37:46 +02:00
|
|
|
class GridContainer;
|
|
|
|
|
2014-02-10 02:10:30 +01:00
|
|
|
class FileDialog : public ConfirmationDialog {
|
2017-03-05 16:44:50 +01:00
|
|
|
GDCLASS(FileDialog, ConfirmationDialog);
|
2016-03-09 00:00:52 +01:00
|
|
|
|
2014-02-10 02:10:30 +01:00
|
|
|
public:
|
|
|
|
enum Access {
|
|
|
|
ACCESS_RESOURCES,
|
|
|
|
ACCESS_USERDATA,
|
|
|
|
ACCESS_FILESYSTEM
|
|
|
|
};
|
|
|
|
|
2020-03-06 18:00:16 +01:00
|
|
|
enum FileMode {
|
|
|
|
FILE_MODE_OPEN_FILE,
|
|
|
|
FILE_MODE_OPEN_FILES,
|
|
|
|
FILE_MODE_OPEN_DIR,
|
|
|
|
FILE_MODE_OPEN_ANY,
|
|
|
|
FILE_MODE_SAVE_FILE
|
2014-02-10 02:10:30 +01:00
|
|
|
};
|
|
|
|
|
2019-06-11 20:43:37 +02:00
|
|
|
typedef Ref<Texture2D> (*GetIconFunc)(const String &);
|
2017-03-05 16:44:50 +01:00
|
|
|
typedef void (*RegisterFunc)(FileDialog *);
|
2014-02-10 02:10:30 +01:00
|
|
|
|
|
|
|
static GetIconFunc get_icon_func;
|
|
|
|
static RegisterFunc register_func;
|
|
|
|
static RegisterFunc unregister_func;
|
|
|
|
|
|
|
|
private:
|
2022-04-04 15:06:57 +02:00
|
|
|
ConfirmationDialog *makedialog = nullptr;
|
|
|
|
LineEdit *makedirname = nullptr;
|
2014-02-10 02:10:30 +01:00
|
|
|
|
2022-04-04 15:06:57 +02:00
|
|
|
Button *makedir = nullptr;
|
2021-02-09 18:24:36 +01:00
|
|
|
Access access = ACCESS_RESOURCES;
|
2022-04-04 15:06:57 +02:00
|
|
|
VBoxContainer *vbox = nullptr;
|
2023-10-13 11:37:46 +02:00
|
|
|
GridContainer *grid_options = nullptr;
|
2020-03-06 18:00:16 +01:00
|
|
|
FileMode mode;
|
2022-04-04 15:06:57 +02:00
|
|
|
LineEdit *dir = nullptr;
|
|
|
|
HBoxContainer *drives_container = nullptr;
|
|
|
|
HBoxContainer *shortcuts_container = nullptr;
|
|
|
|
OptionButton *drives = nullptr;
|
|
|
|
Tree *tree = nullptr;
|
|
|
|
HBoxContainer *file_box = nullptr;
|
|
|
|
LineEdit *file = nullptr;
|
|
|
|
OptionButton *filter = nullptr;
|
|
|
|
AcceptDialog *mkdirerr = nullptr;
|
|
|
|
AcceptDialog *exterr = nullptr;
|
2022-03-23 10:08:58 +01:00
|
|
|
Ref<DirAccess> dir_access;
|
2022-04-04 15:06:57 +02:00
|
|
|
ConfirmationDialog *confirm_save = nullptr;
|
|
|
|
|
|
|
|
Label *message = nullptr;
|
|
|
|
|
|
|
|
Button *dir_prev = nullptr;
|
|
|
|
Button *dir_next = nullptr;
|
|
|
|
Button *dir_up = nullptr;
|
|
|
|
|
|
|
|
Button *refresh = nullptr;
|
|
|
|
Button *show_hidden = nullptr;
|
2016-03-09 00:00:52 +01:00
|
|
|
|
2014-02-10 02:10:30 +01:00
|
|
|
Vector<String> filters;
|
|
|
|
|
2021-03-19 13:01:03 +01:00
|
|
|
Vector<String> local_history;
|
|
|
|
int local_history_pos = 0;
|
|
|
|
void _push_history();
|
|
|
|
|
2021-02-09 18:24:36 +01:00
|
|
|
bool mode_overrides_title = true;
|
2022-03-13 01:35:20 +01:00
|
|
|
String root_subfolder;
|
|
|
|
String root_prefix;
|
2017-12-03 02:54:06 +01:00
|
|
|
|
2015-03-23 15:31:03 +01:00
|
|
|
static bool default_show_hidden_files;
|
2021-02-09 18:24:36 +01:00
|
|
|
bool show_hidden_files = false;
|
2021-03-30 14:42:50 +02:00
|
|
|
bool use_native_dialog = false;
|
2015-03-23 15:31:03 +01:00
|
|
|
|
2023-01-22 18:26:32 +01:00
|
|
|
bool is_invalidating = false;
|
2016-03-09 00:00:52 +01:00
|
|
|
|
2022-09-01 12:38:08 +02:00
|
|
|
struct ThemeCache {
|
|
|
|
Ref<Texture2D> parent_folder;
|
|
|
|
Ref<Texture2D> forward_folder;
|
|
|
|
Ref<Texture2D> back_folder;
|
|
|
|
Ref<Texture2D> reload;
|
|
|
|
Ref<Texture2D> toggle_hidden;
|
|
|
|
Ref<Texture2D> folder;
|
|
|
|
Ref<Texture2D> file;
|
2024-02-25 17:51:50 +01:00
|
|
|
Ref<Texture2D> create_folder;
|
2022-09-01 12:38:08 +02:00
|
|
|
|
2022-09-06 19:09:32 +02:00
|
|
|
Color folder_icon_color;
|
|
|
|
Color file_icon_color;
|
|
|
|
Color file_disabled_color;
|
2022-09-01 12:38:08 +02:00
|
|
|
|
|
|
|
Color icon_normal_color;
|
|
|
|
Color icon_hover_color;
|
|
|
|
Color icon_focus_color;
|
|
|
|
Color icon_pressed_color;
|
|
|
|
} theme_cache;
|
|
|
|
|
2023-10-13 11:37:46 +02:00
|
|
|
struct Option {
|
|
|
|
String name;
|
|
|
|
Vector<String> values;
|
|
|
|
int default_idx = 0;
|
|
|
|
};
|
|
|
|
Vector<Option> options;
|
|
|
|
Dictionary selected_options;
|
|
|
|
bool options_dirty = false;
|
|
|
|
|
2014-02-10 02:10:30 +01:00
|
|
|
void update_dir();
|
2019-06-28 09:29:50 +02:00
|
|
|
void update_file_name();
|
2014-02-10 02:10:30 +01:00
|
|
|
void update_file_list();
|
|
|
|
void update_filters();
|
2016-03-09 00:00:52 +01:00
|
|
|
|
2022-01-03 10:08:03 +01:00
|
|
|
void _focus_file_text();
|
|
|
|
|
2018-08-20 17:45:16 +02:00
|
|
|
void _tree_multi_selected(Object *p_object, int p_cell, bool p_selected);
|
2014-02-10 02:10:30 +01:00
|
|
|
void _tree_selected();
|
2016-03-09 00:00:52 +01:00
|
|
|
|
2014-02-10 02:10:30 +01:00
|
|
|
void _select_drive(int p_idx);
|
2018-02-15 03:44:11 +01:00
|
|
|
void _tree_item_activated();
|
2021-06-16 18:43:34 +02:00
|
|
|
void _dir_submitted(String p_dir);
|
|
|
|
void _file_submitted(const String &p_file);
|
2014-02-10 02:10:30 +01:00
|
|
|
void _action_pressed();
|
|
|
|
void _save_confirm_pressed();
|
|
|
|
void _cancel_pressed();
|
|
|
|
void _filter_selected(int);
|
|
|
|
void _make_dir();
|
|
|
|
void _make_dir_confirm();
|
2017-11-27 16:58:28 +01:00
|
|
|
void _go_up();
|
2021-03-19 13:01:03 +01:00
|
|
|
void _go_back();
|
|
|
|
void _go_forward();
|
2014-02-10 02:10:30 +01:00
|
|
|
|
2022-03-13 01:35:20 +01:00
|
|
|
void _change_dir(const String &p_new_dir);
|
2022-01-24 12:12:46 +01:00
|
|
|
void _update_drives(bool p_select = true);
|
2014-02-10 02:10:30 +01:00
|
|
|
|
2023-01-22 18:26:32 +01:00
|
|
|
void _invalidate();
|
|
|
|
|
2022-01-11 14:59:52 +01:00
|
|
|
virtual void shortcut_input(const Ref<InputEvent> &p_event) override;
|
2015-12-29 00:36:48 +01:00
|
|
|
|
2024-03-21 09:42:38 +01:00
|
|
|
void _native_popup();
|
2023-10-13 11:37:46 +02:00
|
|
|
void _native_dialog_cb(bool p_ok, const Vector<String> &p_files, int p_filter, const Dictionary &p_selected_options);
|
2021-03-30 14:42:50 +02:00
|
|
|
|
2017-11-24 19:12:18 +01:00
|
|
|
bool _is_open_should_be_disabled();
|
|
|
|
|
2023-10-13 11:37:46 +02:00
|
|
|
TypedArray<Dictionary> _get_options() const;
|
|
|
|
void _update_option_controls();
|
|
|
|
void _option_changed_checkbox_toggled(bool p_pressed, const String &p_name);
|
|
|
|
void _option_changed_item_selected(int p_idx, const String &p_name);
|
|
|
|
|
2020-07-10 12:34:39 +02:00
|
|
|
virtual void _post_popup() override;
|
2014-02-10 02:10:30 +01:00
|
|
|
|
|
|
|
protected:
|
2023-09-11 16:24:54 +02:00
|
|
|
void _validate_property(PropertyInfo &p_property) const;
|
2014-02-10 02:10:30 +01:00
|
|
|
void _notification(int p_what);
|
2023-10-13 11:37:46 +02:00
|
|
|
bool _set(const StringName &p_name, const Variant &p_value);
|
|
|
|
bool _get(const StringName &p_name, Variant &r_ret) const;
|
|
|
|
void _get_property_list(List<PropertyInfo> *p_list) const;
|
2014-02-10 02:10:30 +01:00
|
|
|
static void _bind_methods();
|
2023-09-08 21:00:10 +02:00
|
|
|
|
2014-02-10 02:10:30 +01:00
|
|
|
public:
|
2023-09-29 23:40:49 +02:00
|
|
|
virtual void set_visible(bool p_visible) override;
|
2021-03-30 14:42:50 +02:00
|
|
|
virtual void popup(const Rect2i &p_rect = Rect2i()) override;
|
|
|
|
|
2020-07-11 18:45:19 +02:00
|
|
|
void popup_file_dialog();
|
2014-02-10 02:10:30 +01:00
|
|
|
void clear_filters();
|
2022-07-04 23:26:26 +02:00
|
|
|
void add_filter(const String &p_filter, const String &p_description = "");
|
2017-03-05 16:44:50 +01:00
|
|
|
void set_filters(const Vector<String> &p_filters);
|
2016-07-17 01:58:28 +02:00
|
|
|
Vector<String> get_filters() const;
|
2014-02-10 02:10:30 +01:00
|
|
|
|
|
|
|
void set_enable_multiple_selection(bool p_enable);
|
|
|
|
Vector<String> get_selected_files() const;
|
2016-03-09 00:00:52 +01:00
|
|
|
|
2014-02-10 02:10:30 +01:00
|
|
|
String get_current_dir() const;
|
|
|
|
String get_current_file() const;
|
|
|
|
String get_current_path() const;
|
2017-03-05 16:44:50 +01:00
|
|
|
void set_current_dir(const String &p_dir);
|
|
|
|
void set_current_file(const String &p_file);
|
|
|
|
void set_current_path(const String &p_path);
|
2014-02-10 02:10:30 +01:00
|
|
|
|
2023-10-13 11:37:46 +02:00
|
|
|
String get_option_name(int p_option) const;
|
|
|
|
Vector<String> get_option_values(int p_option) const;
|
|
|
|
int get_option_default(int p_option) const;
|
|
|
|
void set_option_name(int p_option, const String &p_name);
|
|
|
|
void set_option_values(int p_option, const Vector<String> &p_values);
|
|
|
|
void set_option_default(int p_option, int p_index);
|
|
|
|
|
|
|
|
void add_option(const String &p_name, const Vector<String> &p_values, int p_index);
|
|
|
|
|
|
|
|
void set_option_count(int p_count);
|
|
|
|
int get_option_count() const;
|
|
|
|
|
|
|
|
Dictionary get_selected_options() const;
|
|
|
|
|
2022-03-13 01:35:20 +01:00
|
|
|
void set_root_subfolder(const String &p_root);
|
|
|
|
String get_root_subfolder() const;
|
|
|
|
|
2017-12-03 02:54:06 +01:00
|
|
|
void set_mode_overrides_title(bool p_override);
|
|
|
|
bool is_mode_overriding_title() const;
|
|
|
|
|
2021-03-30 14:42:50 +02:00
|
|
|
void set_use_native_dialog(bool p_native);
|
|
|
|
bool get_use_native_dialog() const;
|
|
|
|
|
2020-03-06 18:00:16 +01:00
|
|
|
void set_file_mode(FileMode p_mode);
|
|
|
|
FileMode get_file_mode() const;
|
2014-02-10 02:10:30 +01:00
|
|
|
|
|
|
|
VBoxContainer *get_vbox();
|
|
|
|
LineEdit *get_line_edit() { return file; }
|
|
|
|
|
|
|
|
void set_access(Access p_access);
|
|
|
|
Access get_access() const;
|
|
|
|
|
2015-03-23 15:31:03 +01:00
|
|
|
void set_show_hidden_files(bool p_show);
|
|
|
|
bool is_showing_hidden_files() const;
|
|
|
|
|
|
|
|
static void set_default_show_hidden_files(bool p_show);
|
|
|
|
|
2014-02-10 02:10:30 +01:00
|
|
|
void invalidate();
|
2016-03-09 00:00:52 +01:00
|
|
|
|
2020-12-21 11:26:41 +01:00
|
|
|
void deselect_all();
|
2017-11-27 16:58:28 +01:00
|
|
|
|
2016-03-09 00:00:52 +01:00
|
|
|
FileDialog();
|
2014-02-10 02:10:30 +01:00
|
|
|
~FileDialog();
|
|
|
|
};
|
|
|
|
|
2020-03-06 18:00:16 +01:00
|
|
|
VARIANT_ENUM_CAST(FileDialog::FileMode);
|
2017-03-05 16:44:50 +01:00
|
|
|
VARIANT_ENUM_CAST(FileDialog::Access);
|
2014-02-10 02:10:30 +01:00
|
|
|
|
2022-07-23 23:41:51 +02:00
|
|
|
#endif // FILE_DIALOG_H
|