summaryrefslogtreecommitdiff
path: root/doc/classes/EditorCommandPalette.xml
blob: 380c79fc1a5f0fdf8653a50427b30bf0f4fdf933 (plain)
1
2
3
4
5
6
7
8
9
10
11
12
13
14
15
16
17
18
19
20
21
22
23
24
25
26
27
28
29
30
31
32
33
34
35
36
37
38
39
40
41
42
43
44
45
46
47
48
49
50
51
52
53
54
<?xml version="1.0" encoding="UTF-8" ?>
<class name="EditorCommandPalette" inherits="ConfirmationDialog" version="4.0" xmlns:xsi="http://www.w3.org/2001/XMLSchema-instance" xsi:noNamespaceSchemaLocation="../class.xsd">
	<brief_description>
		Godot editor's command palette.
	</brief_description>
	<description>
		Object that holds all the available Commands and their shortcuts text. These Commands can be accessed through [b]Editor &gt; Command Palette[/b] menu.
		Command key names use slash delimiters to distinguish sections, for example: [code]"example/command1"[/code] then [code]example[/code] will be the section name.
		[codeblocks]
		[gdscript]
		var command_palette = get_editor_interface().get_command_palette()
		# external_command is a function that will be called with the command is executed.
		var command_callable = Callable(self, "external_command").bind(arguments)
		command_palette.add_command("command", "test/command",command_callable)
		[/gdscript]
		[csharp]
		EditorCommandPalette commandPalette = GetEditorInterface().GetCommandPalette();
		// ExternalCommand is a function that will be called with the command is executed.
		Callable commandCallable = new Callable(this, nameof(ExternalCommand));
		commandPalette.AddCommand("command", "test/command", commandCallable)
		[/csharp]
		[/codeblocks]
		[b]Note:[/b] This class shouldn't be instantiated directly. Instead, access the singleton using [method EditorInterface.get_command_palette].
	</description>
	<tutorials>
	</tutorials>
	<methods>
		<method name="add_command">
			<return type="void" />
			<param index="0" name="command_name" type="String" />
			<param index="1" name="key_name" type="String" />
			<param index="2" name="binded_callable" type="Callable" />
			<param index="3" name="shortcut_text" type="String" default="&quot;None&quot;" />
			<description>
				Adds a custom command to EditorCommandPalette.
				- [param command_name]: [String] (Name of the [b]Command[/b]. This is displayed to the user.)
				- [param key_name]: [String] (Name of the key for a particular [b]Command[/b]. This is used to uniquely identify the [b]Command[/b].)
				- [param binded_callable]: [Callable] (Callable of the [b]Command[/b]. This will be executed when the [b]Command[/b] is selected.)
				- [param shortcut_text]: [String] (Shortcut text of the [b]Command[/b] if available.)
			</description>
		</method>
		<method name="remove_command">
			<return type="void" />
			<param index="0" name="key_name" type="String" />
			<description>
				Removes the custom command from EditorCommandPalette.
				- [param key_name]: [String] (Name of the key for a particular [b]Command[/b].)
			</description>
		</method>
	</methods>
	<members>
		<member name="dialog_hide_on_ok" type="bool" setter="set_hide_on_ok" getter="get_hide_on_ok" overrides="AcceptDialog" default="false" />
	</members>
</class>