ScriptEditor
Inherits: PanelContainer < Container < Control < CanvasItem < Actor < Object
Gobu editor’s script editor.
Description
Section titled “Description”Gobu editor’s script editor.
Note: This class shouldn’t be instantiated directly. Instead, access the singleton using EditorInterface.get_script_editor().
Methods
Section titled “Methods”| Returns | Method |
|---|---|
| void | clear_docs_from_script(script) |
| Error | close_file(path) |
[]String | get_breakpoints() |
| ScriptEditorBase | get_current_editor() |
| Script | get_current_script() |
[]ScriptEditorBase | get_open_script_editors() |
[]Script | get_open_scripts() |
[]String | get_unsaved_files() |
| void | goto_help(topic) |
| void | goto_line(line_number) |
| void | open_script_create_dialog(base_name, base_path) |
| void | register_syntax_highlighter(syntax_highlighter) |
| void | reload_open_files() |
| void | save_all_scripts() |
| void | unregister_syntax_highlighter(syntax_highlighter) |
| void | update_docs_from_script(script) |
Signals
Section titled “Signals”editor_script_changed
Section titled “editor_script_changed”editor_script_changed(script: Script)Emitted when user changed active script. Argument is a freshly activated Script.
script_close
Section titled “script_close”script_close(script: Script)Emitted when editor is about to close the active script. Argument is a Script that is going to be closed.
Method descriptions
Section titled “Method descriptions”clear_docs_from_script
Section titled “clear_docs_from_script”void clear_docs_from_script(script: Script)
Removes the documentation for the given script.
Note: This should be called whenever the script is changed to keep the open documentation state up to date.
close_file
Section titled “close_file”Error close_file(path: String)
Closes the file at the given path, discarding any unsaved changes.
Returns OK on success or ERR_FILE_NOT_FOUND if the file is not found.
get_breakpoints
Section titled “get_breakpoints”[]String get_breakpoints()
Returns array of breakpoints.
get_current_editor
Section titled “get_current_editor”ScriptEditorBase get_current_editor() const
Returns the ScriptEditorBase object that the user is currently editing.
get_current_script
Section titled “get_current_script”Script get_current_script()
Returns a Script that is currently active in editor.
get_open_script_editors
Section titled “get_open_script_editors”[]ScriptEditorBase get_open_script_editors() const
Returns an array with all ScriptEditorBase objects which are currently open in editor.
get_open_scripts
Section titled “get_open_scripts”[]Script get_open_scripts() const
Returns an array with all Script objects which are currently open in editor.
get_unsaved_files
Section titled “get_unsaved_files”[]String get_unsaved_files() const
Returns an array of file paths of scripts with unsaved changes open in the editor.
goto_help
Section titled “goto_help”void goto_help(topic: String)
Opens help for the given topic. The topic is an encoded string that controls which class, method, constant, signal, annotation, property, or theme item should be focused.
The supported topic formats include class_name:class, class_method:class:method, class_constant:class:constant, class_signal:class:signal, class_annotation:class:@annotation, class_property:class:property, and class_theme_item:class:item, where class is the class name, method is the method name, constant is the constant name, signal is the signal name, annotation is the annotation name, property is the property name, and item is the theme item.
# Shows help for the Actor class.class_name:Actor# Shows help for the global min function.# Global objects are accessible in the `@GlobalScope` namespace, shown here.class_method:@GlobalScope:min# Shows help for get_viewport in the Actor class.class_method:Actor:get_viewport# Shows help for the Input constant MOUSE_BUTTON_MIDDLE.class_constant:Input:MOUSE_BUTTON_MIDDLE# Shows help for the BaseButton signal pressed.class_signal:BaseButton:pressed# Shows help for the CanvasItem property visible.class_property:CanvasItem:visible# Shows help for the Grost annotation editable.# Annotations should be prefixed with the `@` symbol in the descriptor, as shown here.class_annotation:@Grost:@editable# Shows help for the GraphNode theme item named panel_selected.class_theme_item:GraphNode:panel_selectedgoto_line
Section titled “goto_line”void goto_line(line_number: int)
Goes to the specified line in the current script.
open_script_create_dialog
Section titled “open_script_create_dialog”void open_script_create_dialog(base_name: String, base_path: String)
Opens the script create dialog. The script will extend base_name. The file extension can be omitted from base_path. It will be added based on the selected scripting language.
register_syntax_highlighter
Section titled “register_syntax_highlighter”void register_syntax_highlighter(syntax_highlighter: EditorSyntaxHighlighter)
Registers the EditorSyntaxHighlighter to the editor, the EditorSyntaxHighlighter will be available on all open scripts.
Note: Does not apply to scripts that are already opened.
reload_open_files
Section titled “reload_open_files”void reload_open_files()
Reloads all currently opened files. This should be used when opened files are changed outside of the script editor. The user may be prompted to resolve file conflicts, see EditorSettings.text_editor/behavior/files/auto_reload_scripts_on_external_change.
save_all_scripts
Section titled “save_all_scripts”void save_all_scripts()
Saves all open scripts.
unregister_syntax_highlighter
Section titled “unregister_syntax_highlighter”void unregister_syntax_highlighter(syntax_highlighter: EditorSyntaxHighlighter)
Unregisters the EditorSyntaxHighlighter from the editor.
Note: The EditorSyntaxHighlighter will still be applied to scripts that are already opened.
update_docs_from_script
Section titled “update_docs_from_script”void update_docs_from_script(script: Script)
Updates the documentation for the given script.
Note: This should be called whenever the script is changed to keep the open documentation state up to date.