FileDialog

public FileDialog();

Создаёт скрытый диалог в режиме SaveFile и области Resources. Начальная конфигурация не создаёт файл и не открывает системное окно.

public FileDialog.AccessEnum Access { get; set; }

Область навигации: Resources (asset://), Userdata (user://) или Filesystem. По умолчанию Resources. Не выдаёт права ОС; смена сбрасывает RootSubfolder и состояние каталога следует настроить заново.

public string CurrentDir { get; set; }

Текущий каталог, не выбранный файл. Предпочитайте явный путь asset://, user:// или абсолютный путь под выбранный Access. Setter не создаёт каталог и не означает успешное подтверждение.

public string CurrentFile { get; set; }

Текст поля имени, обычно без каталога. Не загружает и не создаёт файл, не испускает FileSelected. Для полного пути используйте CurrentPath.

public string CurrentPath { get; set; }

Объединение CurrentDir и CurrentFile. Setter полного пути задаёт каталог и имя; путь без разделителя меняет только имя, пустая строка — no-op. Не является доказательством существования файла.

public bool DeletingEnabled { get; set; }

Разрешает действие удаления в меню встроенного списка, перемещающее выбранный объект в корзину при выполнении. Сам флаг ничего не удаляет; false не запрещает FileAccess/DirAccess приложения.

public FileDialog.DisplayModeEnum DisplayMode { get; set; }

Вид встроенного списка: Thumbnails или List. Не меняет FileMode, Access и результат чтения файла. Наличие качественной миниатюры зависит от настроенного источника миниатюр.

public bool DriveSelectorEnabled { get; set; }

Показывать список дисков, когда он применим к текущему Access/платформе. Не выдаёт доступ ко всем дискам ОС.

public bool FavoritesEnabled { get; set; }

Показывать избранное во встроенном UI. Не очищает общий список SetFavoriteList.

public bool FileFilterToggleEnabled { get; set; }

Показывать кнопку включения строки поиска имён. true показывает кнопку, но не включает сам поиск; это не список масок расширений Filters.

public FileDialog.FileModeEnum FileMode { get; set; }

Режим выбора: OpenFile, OpenFiles, OpenDir, OpenAny или SaveFile. SaveFile по умолчанию. Меняет стандартные подписи/тип выделения, не выполняет файловую операцию; пользовательский Title сохраняется.

public string FileNameFilter { get; set; }

Поисковый текст имён во встроенном списке, отдельно от масок расширений Filters. При выключенной строке поиска setter сбрасывает запрос. Для постоянного ограничения расширений используйте Filters. Не считайте аргумент FileNameFilterChanged надёжным: в установленном Runtime есть несовпадение типа.

public bool FileSortOptionsEnabled { get; set; }

Показывать UI сортировки файлов. Не меняет имя, содержимое файла или порядок массива Filters.

public string[] Filters { get; set; }

Массив строк маска ; подпись ; MIME, последние части необязательны. Несколько масок в группе разделяются запятой. Getter возвращает копию; setter заменяет список, не валидируя содержимое файлов.

public bool FiltersEnabled { get; set; }

Показывать список фильтров расширений. Не очищает Filters и не является кнопкой строки поиска имён.

public bool FolderCreationEnabled { get; set; }

Разрешает UI создания каталога в подходящем FileMode. Не создаёт каталог при присваивании и не запрещает собственные вызовы DirAccess.

public bool HiddenFilesToggleEnabled { get; set; }

Показывать кнопку скрытых файлов. Не равно ShowHiddenFiles: скрытие кнопки не меняет текущее включение скрытых элементов.

public bool LayoutToggleEnabled { get; set; }

Показывать переключатель Thumbnails/List. Не сбрасывает текущий DisplayMode.

public bool ModeOverridesTitle { get; set; }

Старый флаг: setter ничего не делает, getter возвращает true. Для своего заголовка задайте Title; в установленном SDK пользовательский Title сохраняется при смене FileMode.

public bool NavigationButtonsEnabled { get; set; }

Показывать кнопки назад/вперёд. Не блокирует программные CurrentDir/CurrentPath.

public int OptionCount { get; set; }

Количество дополнительных настроек. Уменьшение сохраняет префикс списка; увеличение создаёт пустые записи, которым нужно задать уникальные имена, values и default. Изменение может пересоздать UI и сбросить текущие ответы к defaults.

public bool OverwriteWarningEnabled { get; set; }

Запрашивать подтверждение существующего пути в SaveFile. FileDialog не выполняет запись; даже после подтверждения проверяйте результат собственного сохранения.

public bool RecentListEnabled { get; set; }

Показывать недавние каталоги во встроенном UI. Не очищает общий список SetRecentList.

public string RootSubfolder { get; set; }

Существующий каталог, ограничивающий навигацию встроенного UI в текущей области Access. Пустая строка снимает настройку; смена Access сбрасывает её. Не создаёт каталог и не является границей безопасности для собственного FileAccess — проверяйте конечный путь отдельно.

public bool ShowHiddenFiles { get; set; }

Показывать скрытые элементы во встроенном списке, false по умолчанию. Не переключает FileMode и не выдаёт права доступа к скрытым/защищённым файлам.

public bool UseNativeDialog { get; set; }

Запрос системного окна при поддержке нужных возможностей платформой. false не гарантирует встроенный UI в sandbox ОС; true не гарантирует поддержку произвольных добавленных Control. Настраивайте до открытия.

public void AddFilter(string filter, string description);

Короткая перегрузка добавляет маску и подпись с пустым MIME. Для MIME используйте перегрузку с mimeType; фильтр не проверяет содержимое файла.

public void AddFilter(string filter, string description = "", string mimeType = "");

Добавляет группу масок, подпись и необязательный MIME. Пример маски: .png,.jpg; .png без * не используйте. Не подтверждает выбор и не доказывает формат содержимого.

public void AddOption(string name, ReadOnlySpan<string> values, int defaultValueIndex);

Добавляет дополнительную настройку с уникальным name. Пустой values создаёт checkbox с defaultValueIndex 0/1, непустой — список с индексом 0…Length-1; default ограничивается диапазоном. Встроенные контролы создаются при обновлении видимого диалога.

public void AddOption(string name, string[] values, int defaultValueIndex);

Добавляет дополнительную настройку с уникальным name. Пустой values создаёт checkbox с defaultValueIndex 0/1, непустой — список с индексом 0…Length-1; default ограничивается диапазоном. Встроенные контролы создаются при обновлении видимого диалога.

public void ClearFileNameFilter();

Очищает поисковый запрос имён и обновляет встроенный UI. Не удаляет маски Filters, выбранный путь или файлы. При обработке уведомления учитывайте несовпадение payload FileNameFilterChanged.

public void ClearFilters();

Удаляет группы фильтров, сохраняя текст имени. Это не сброс пути и не снятие всех пользовательских ограничений ОС.

public void DeselectAll();

Снимает выделение элементов списка и обновляет доступность подтверждения. Не удаляет файлы и не испускает успешный выбор.

public FileDialog.AccessEnum GetAccess();

Область навигации: Resources (asset://), Userdata (user://) или Filesystem. По умолчанию Resources. Не выдаёт права ОС; смена сбрасывает RootSubfolder и состояние каталога следует настроить заново.

public string GetCurrentDir();

Текущий каталог, не выбранный файл. Предпочитайте явный путь asset://, user:// или абсолютный путь под выбранный Access. Setter не создаёт каталог и не означает успешное подтверждение.

public string GetCurrentFile();

Текст поля имени, обычно без каталога. Не загружает и не создаёт файл, не испускает FileSelected. Для полного пути используйте CurrentPath.

public string GetCurrentPath();

Объединение CurrentDir и CurrentFile. Setter полного пути задаёт каталог и имя; путь без разделителя меняет только имя, пустая строка — no-op. Не является доказательством существования файла.

public FileDialog.DisplayModeEnum GetDisplayMode();

Вид встроенного списка: Thumbnails или List. Не меняет FileMode, Access и результат чтения файла. Наличие качественной миниатюры зависит от настроенного источника миниатюр.

public static string[] GetFavoriteList();

Главный поток: возвращает копию общего списка избранных каталогов. Изменение массива не меняет глобальный список; используйте SetFavoriteList.

public FileDialog.FileModeEnum GetFileMode();

Режим выбора: OpenFile, OpenFiles, OpenDir, OpenAny или SaveFile. SaveFile по умолчанию. Меняет стандартные подписи/тип выделения, не выполняет файловую операцию; пользовательский Title сохраняется.

public string GetFileNameFilter();

Поисковый текст имён во встроенном списке, отдельно от масок расширений Filters. При выключенной строке поиска setter сбрасывает запрос. Для постоянного ограничения расширений используйте Filters. Не считайте аргумент FileNameFilterChanged надёжным: в установленном Runtime есть несовпадение типа.

public string[] GetFilters();

Массив строк маска ; подпись ; MIME, последние части необязательны. Несколько масок в группе разделяются запятой. Getter возвращает копию; setter заменяет список, не валидируя содержимое файлов.

public LineEdit GetLineEdit();

Общее внутреннее поле имени файла. Его Text отражается в CurrentFile; это не поле фильтра. Не освобождайте и не переносите отдельно; не является контролом системного окна ОС.

public int GetOptionCount();

Количество дополнительных настроек. Уменьшение сохраняет префикс списка; увеличение создаёт пустые записи, которым нужно задать уникальные имена, values и default. Изменение может пересоздать UI и сбросить текущие ответы к defaults.

public int GetOptionDefault(int option);

Возвращает default схемы, не текущее пользовательское значение: 0/1 для checkbox либо индекс варианта.

public string GetOptionName(int option);

Имя настройки по обычному допустимому индексу. Используется ключом GetSelectedOptions, поэтому имена должны быть уникальными и стабильными.

public string[] GetOptionValues(int option);

Возвращает копию массива подписей вариантов. Пустой массив означает checkbox, не отсутствие настройки. Изменяйте через SetOptionValues.

public static string[] GetRecentList();

Главный поток: копия общего списка недавних каталогов. Это каталоги навигации, не журнал всех открытых файлов.

public string GetRootSubfolder();

Существующий каталог, ограничивающий навигацию встроенного UI в текущей области Access. Пустая строка снимает настройку; смена Access сбрасывает её. Не создаёт каталог и не является границей безопасности для собственного FileAccess — проверяйте конечный путь отдельно.

public Reckfell.Collections.Dictionary GetSelectedOptions();

Возвращает общий Dictionary name → bool/индекс текущего выбора. До построения контролов он может быть пустым, даже если OptionCount > 0. Перестройка опций сбрасывает его к defaults. Скопируйте нужные значения в модель после принятия выбора; не редактируйте словарь как официальный setter.

public bool GetUseNativeDialog();

Запрос системного окна при поддержке нужных возможностей платформой. false не гарантирует встроенный UI в sandbox ОС; true не гарантирует поддержку произвольных добавленных Control. Настраивайте до открытия.

public VBoxContainer GetVBox();

Общий внутренний VBoxContainer встроенного диалога. Добавляйте нужный UI, сохраняя владение контейнером за FileDialog; системный backend не обязан показывать эти Control.

public void Invalidate();

Планирует обновление видимого встроенного списка; для скрытого диалога ничего немедленно не сканирует. Не является проверкой существования файла или подтверждением выбора.

public bool IsCustomizationFlagEnabled(FileDialog.Customization flag);

Возвращает настройку Customization указанного экземпляра. Это политика UI/подтверждения, не разрешение ОС на файловую операцию.

public bool IsModeOverridingTitle();

Старый флаг: setter ничего не делает, getter возвращает true. Для своего заголовка задайте Title; в установленном SDK пользовательский Title сохраняется при смене FileMode.

public bool IsShowingHiddenFiles();

Показывать скрытые элементы во встроенном списке, false по умолчанию. Не переключает FileMode и не выдаёт права доступа к скрытым/защищённым файлам.

public void PopupFileDialog();

Открывает диалог со штатным размером/ограничением относительно viewport. До вызова задайте режим, область, фильтры и обработчики выбора. Может использовать системный backend; сам файл не читает/не пишет.

public void SetAccess(FileDialog.AccessEnum access);

Область навигации: Resources (asset://), Userdata (user://) или Filesystem. По умолчанию Resources. Не выдаёт права ОС; смена сбрасывает RootSubfolder и состояние каталога следует настроить заново.

public void SetCurrentDir(string dir);

Текущий каталог, не выбранный файл. Предпочитайте явный путь asset://, user:// или абсолютный путь под выбранный Access. Setter не создаёт каталог и не означает успешное подтверждение.

public void SetCurrentFile(string file);

Текст поля имени, обычно без каталога. Не загружает и не создаёт файл, не испускает FileSelected. Для полного пути используйте CurrentPath.

public void SetCurrentPath(string path);

Объединение CurrentDir и CurrentFile. Setter полного пути задаёт каталог и имя; путь без разделителя меняет только имя, пустая строка — no-op. Не является доказательством существования файла.

public void SetCustomizationFlagEnabled(FileDialog.Customization flag, bool enabled);

Меняет указанную настройку UI/подтверждения. Не выполняет операцию с файлами, не меняет модель приложения и не выдаёт права ОС.

public void SetDisplayMode(FileDialog.DisplayModeEnum mode);

Вид встроенного списка: Thumbnails или List. Не меняет FileMode, Access и результат чтения файла. Наличие качественной миниатюры зависит от настроенного источника миниатюр.

public static void SetFavoriteList(ReadOnlySpan<string> favorites);

Заменяет общий для FileDialog список избранных каталогов процесса; вызывайте в главном потоке. Добавляет завершающий /. Не отдельный список экземпляра и не автоматическое сохранение на диск. Список UI обновляется отдельно.

public static void SetFavoriteList(string[] favorites);

Заменяет общий для FileDialog список избранных каталогов процесса; вызывайте в главном потоке. Добавляет завершающий /. Не отдельный список экземпляра и не автоматическое сохранение на диск. Список UI обновляется отдельно.

public void SetFileMode(FileDialog.FileModeEnum mode);

Режим выбора: OpenFile, OpenFiles, OpenDir, OpenAny или SaveFile. SaveFile по умолчанию. Меняет стандартные подписи/тип выделения, не выполняет файловую операцию; пользовательский Title сохраняется.

public void SetFileNameFilter(string filter);

Поисковый текст имён во встроенном списке, отдельно от масок расширений Filters. При выключенной строке поиска setter сбрасывает запрос. Для постоянного ограничения расширений используйте Filters. Не считайте аргумент FileNameFilterChanged надёжным: в установленном Runtime есть несовпадение типа.

public void SetFilters(ReadOnlySpan<string> filters);

Массив строк маска ; подпись ; MIME, последние части необязательны. Несколько масок в группе разделяются запятой. Getter возвращает копию; setter заменяет список, не валидируя содержимое файлов.

public void SetFilters(string[] filters);

Массив строк маска ; подпись ; MIME, последние части необязательны. Несколько масок в группе разделяются запятой. Getter возвращает копию; setter заменяет список, не валидируя содержимое файлов.

public static void SetGetIconCallback(Callable callback);

Устанавливает общий статический поставщик иконок для встроенных FileDialog: Callable получает один string пути и возвращает Texture2D либо null для fallback. Не настройка одного экземпляра. Не захватывайте короткоживущий диалог; управляйте сроком жизни поставщика на уровне приложения.

public static void SetGetThumbnailCallback(Callable callback);

Общий статический поставщик миниатюр: один string пути → Texture2D либо null для стандартного fallback. Работает во встроенном режиме Thumbnails, не гарантирует миниатюры системного окна. Кэшируйте готовые изображения; не блокируйте UI тяжёлой генерацией в callback.

public void SetModeOverridesTitle(bool @override);

Старый флаг: setter ничего не делает, getter возвращает true. Для своего заголовка задайте Title; в установленном SDK пользовательский Title сохраняется при смене FileMode.

public void SetOptionCount(int count);

Количество дополнительных настроек. Уменьшение сохраняет префикс списка; увеличение создаёт пустые записи, которым нужно задать уникальные имена, values и default. Изменение может пересоздать UI и сбросить текущие ответы к defaults.

public void SetOptionDefault(int option, int defaultValueIndex);

Задаёт default с ограничением 0…1 для checkbox или 0…values.Length-1 для списка. Принимает отрицательный индекс настройки; не используйте как тихое изменение одного текущего ответа в открытом диалоге.

public void SetOptionName(int option, string name);

Меняет ключ/подпись настройки; принимает отрицательный индекс с конца. Пересоздание контролов может сбросить текущие ответы: настройте схему до открытия.

public void SetOptionValues(int option, ReadOnlySpan<string> values);

Заменяет варианты, копируя массив; пустой массив переключает настройку в checkbox. Сохранённый default ограничивается новым диапазоном. Принимает отрицательный индекс; может пересоздать UI.

public void SetOptionValues(int option, string[] values);

Заменяет варианты, копируя массив; пустой массив переключает настройку в checkbox. Сохранённый default ограничивается новым диапазоном. Принимает отрицательный индекс; может пересоздать UI.

public static void SetRecentList(ReadOnlySpan<string> recents);

Заменяет общий список недавних каталогов процесса из главного потока, добавляя завершающий /. Не перезаписывает пользовательский файл настроек сам по себе.

public static void SetRecentList(string[] recents);

Заменяет общий список недавних каталогов процесса из главного потока, добавляя завершающий /. Не перезаписывает пользовательский файл настроек сам по себе.

public void SetRootSubfolder(string dir);

Существующий каталог, ограничивающий навигацию встроенного UI в текущей области Access. Пустая строка снимает настройку; смена Access сбрасывает её. Не создаёт каталог и не является границей безопасности для собственного FileAccess — проверяйте конечный путь отдельно.

public void SetShowHiddenFiles(bool show);

Показывать скрытые элементы во встроенном списке, false по умолчанию. Не переключает FileMode и не выдаёт права доступа к скрытым/защищённым файлам.

public void SetUseNativeDialog(bool native);

Запрос системного окна при поддержке нужных возможностей платформой. false не гарантирует встроенный UI в sandbox ОС; true не гарантирует поддержку произвольных добавленных Control. Настраивайте до открытия.

public event FileDialog.DirSelectedEventHandler DirSelected;

Принят каталог при OpenDir или каталоговый результат OpenAny. Это каталог, не имя для записи файла; FileDialog его не создаёт по факту сигнала.

public event FileDialog.FileNameFilterChangedEventHandler FileNameFilterChanged;

Ограничение Runtime/SDK 1.0.0: нативный сигнал передаёт объект OptionButton, хотя SDK объявляет string. Не используйте filter как текст. Рабочий обход: Connect(FileDialog.SignalName.FileNameFilterChanged, Callable.From<Variant>(handler)), где handler игнорирует payload и читает FileNameFilter у диалога. Сохраните Callable для Disconnect.

public event FileDialog.FileSelectedEventHandler FileSelected;

Подтверждён один путь: OpenFile, файловый результат OpenAny либо SaveFile. При SaveFile путь может ещё не существовать. Сигнал не означает успешное чтение или запись — выполните и проверьте операцию отдельно.

public event FileDialog.FilesSelectedEventHandler FilesSelected;

Принят массив путей при OpenFiles. Проверьте каждый путь/файл отдельно; изменение настроек или CurrentPath этот сигнал не испускает.