godotengine
/
godot
1
0
Fork 0
Code Issues Pull Requests Packages Projects Releases Wiki Activity
godot/doc/classes/Signal.xml

124 lines
3.7 KiB
XML
Raw Normal View History

doc: Sync classref with StringName/Callable changes
2020-02-22 13:59:09 +00:00
<?xml version="1.0" encoding="UTF-8" ?>
Add an XML schema for documentation 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.
2022-02-14 13:18:53 +00:00
<class name="Signal" version="4.0" xmlns:xsi="http://www.w3.org/2001/XMLSchema-instance" xsi:noNamespaceSchemaLocation="../class.xsd">
doc: Sync classref with StringName/Callable changes
2020-02-22 13:59:09 +00:00
<brief_description>
Add LOTS of missing docs
2020-03-03 18:21:21 +00:00
Class representing a signal defined in an object.
doc: Sync classref with StringName/Callable changes
2020-02-22 13:59:09 +00:00
</brief_description>
<description>
</description>
<tutorials>
</tutorials>
Move the docs for constructors and operators out of methods section
2021-09-21 02:49:02 +00:00
<constructors>
<constructor name="Signal">
doc: Use self-closing tags for `return` and `argument` For the time being we don't support writing a description for those, preferring having all details in the method's description. Using self-closing tags saves half the lines, and prevents contributors from thinking that they should write the argument or return documentation there.
2021-07-30 13:28:05 +00:00
<return type="Signal" />
Variant: Sync docs with new constructors, fixups after #43403 Change DocData comparators for MethodDoc and ArgumentDoc to get a better ordering of constructors.
2020-11-09 16:46:03 +00:00
<description>
Constructs a null [Signal] with no object nor signal name bound.
</description>
Move the docs for constructors and operators out of methods section
2021-09-21 02:49:02 +00:00
</constructor>
<constructor name="Signal">
doc: Use self-closing tags for `return` and `argument` For the time being we don't support writing a description for those, preferring having all details in the method's description. Using self-closing tags saves half the lines, and prevents contributors from thinking that they should write the argument or return documentation there.
2021-07-30 13:28:05 +00:00
<return type="Signal" />
<argument index="0" name="from" type="Signal" />
Variant: Sync docs with new constructors, fixups after #43403 Change DocData comparators for MethodDoc and ArgumentDoc to get a better ordering of constructors.
2020-11-09 16:46:03 +00:00
<description>
Constructs a [Signal] as a copy of the given [Signal].
</description>
Move the docs for constructors and operators out of methods section
2021-09-21 02:49:02 +00:00
</constructor>
<constructor name="Signal">
doc: Use self-closing tags for `return` and `argument` For the time being we don't support writing a description for those, preferring having all details in the method's description. Using self-closing tags saves half the lines, and prevents contributors from thinking that they should write the argument or return documentation there.
2021-07-30 13:28:05 +00:00
<return type="Signal" />
<argument index="0" name="object" type="Object" />
<argument index="1" name="signal" type="StringName" />
doc: Sync classref with StringName/Callable changes
2020-02-22 13:59:09 +00:00
<description>
Variant: Sync docs with new constructors, fixups after #43403 Change DocData comparators for MethodDoc and ArgumentDoc to get a better ordering of constructors.
2020-11-09 16:46:03 +00:00
Creates a new [Signal] with the name [code]signal[/code] in the specified [code]object[/code].
doc: Sync classref with StringName/Callable changes
2020-02-22 13:59:09 +00:00
</description>
Move the docs for constructors and operators out of methods section
2021-09-21 02:49:02 +00:00
</constructor>
</constructors>
<methods>
doc: Sync classref with StringName/Callable changes
2020-02-22 13:59:09 +00:00
<method name="connect">
doc: Use self-closing tags for `return` and `argument` For the time being we don't support writing a description for those, preferring having all details in the method's description. Using self-closing tags saves half the lines, and prevents contributors from thinking that they should write the argument or return documentation there.
2021-07-30 13:28:05 +00:00
<return type="int" />
<argument index="0" name="callable" type="Callable" />
Remove binds from Signal.connect
2021-09-19 16:55:23 +00:00
<argument index="1" name="flags" type="int" default="0" />
doc: Sync classref with StringName/Callable changes
2020-02-22 13:59:09 +00:00
<description>
Remove binds from Signal.connect
2021-09-19 16:55:23 +00:00
Connects this signal to the specified [Callable], optionally providing connection flags. You can provide additional arguments to the connected method call by using [method Callable.bind].
[codeblock]
for button in $Buttons.get_children():
button.pressed.connect(on_pressed.bind(button))
func on_pressed(button):
print(button.name, " was pressed")
[/codeblock]
doc: Sync classref with StringName/Callable changes
2020-02-22 13:59:09 +00:00
</description>
</method>
<method name="disconnect">
doc: Use self-closing tags for `return` and `argument` For the time being we don't support writing a description for those, preferring having all details in the method's description. Using self-closing tags saves half the lines, and prevents contributors from thinking that they should write the argument or return documentation there.
2021-07-30 13:28:05 +00:00
<return type="void" />
<argument index="0" name="callable" type="Callable" />
doc: Sync classref with StringName/Callable changes
2020-02-22 13:59:09 +00:00
<description>
Add LOTS of missing docs
2020-03-03 18:21:21 +00:00
Disconnects this signal from the specified [Callable].
doc: Sync classref with StringName/Callable changes
2020-02-22 13:59:09 +00:00
</description>
</method>
doc: Sync classref with current source And move GLTF docs to its module folder.
2021-03-18 13:44:42 +00:00
<method name="emit" qualifiers="vararg const">
doc: Use self-closing tags for `return` and `argument` For the time being we don't support writing a description for those, preferring having all details in the method's description. Using self-closing tags saves half the lines, and prevents contributors from thinking that they should write the argument or return documentation there.
2021-07-30 13:28:05 +00:00
<return type="void" />
doc: Sync classref with StringName/Callable changes
2020-02-22 13:59:09 +00:00
<description>
Add LOTS of missing docs
2020-03-03 18:21:21 +00:00
Emits this signal to all connected objects.
doc: Sync classref with StringName/Callable changes
2020-02-22 13:59:09 +00:00
</description>
</method>
doc: Sync classref with current source And move GLTF docs to its module folder.
2021-03-18 13:44:42 +00:00
<method name="get_connections" qualifiers="const">
doc: Use self-closing tags for `return` and `argument` For the time being we don't support writing a description for those, preferring having all details in the method's description. Using self-closing tags saves half the lines, and prevents contributors from thinking that they should write the argument or return documentation there.
2021-07-30 13:28:05 +00:00
<return type="Array" />
doc: Sync classref with StringName/Callable changes
2020-02-22 13:59:09 +00:00
<description>
Add LOTS of missing docs
2020-03-03 18:21:21 +00:00
Returns the list of [Callable]s connected to this signal.
doc: Sync classref with StringName/Callable changes
2020-02-22 13:59:09 +00:00
</description>
</method>
doc: Sync classref with current source And move GLTF docs to its module folder.
2021-03-18 13:44:42 +00:00
<method name="get_name" qualifiers="const">
doc: Use self-closing tags for `return` and `argument` For the time being we don't support writing a description for those, preferring having all details in the method's description. Using self-closing tags saves half the lines, and prevents contributors from thinking that they should write the argument or return documentation there.
2021-07-30 13:28:05 +00:00
<return type="StringName" />
doc: Sync classref with StringName/Callable changes
2020-02-22 13:59:09 +00:00
<description>
Add LOTS of missing docs
2020-03-03 18:21:21 +00:00
Returns the name of this signal.
doc: Sync classref with StringName/Callable changes
2020-02-22 13:59:09 +00:00
</description>
</method>
doc: Sync classref with current source And move GLTF docs to its module folder.
2021-03-18 13:44:42 +00:00
<method name="get_object" qualifiers="const">
doc: Use self-closing tags for `return` and `argument` For the time being we don't support writing a description for those, preferring having all details in the method's description. Using self-closing tags saves half the lines, and prevents contributors from thinking that they should write the argument or return documentation there.
2021-07-30 13:28:05 +00:00
<return type="Object" />
doc: Sync classref with StringName/Callable changes
2020-02-22 13:59:09 +00:00
<description>
Add LOTS of missing docs
2020-03-03 18:21:21 +00:00
Returns the object emitting this signal.
doc: Sync classref with StringName/Callable changes
2020-02-22 13:59:09 +00:00
</description>
</method>
doc: Sync classref with current source And move GLTF docs to its module folder.
2021-03-18 13:44:42 +00:00
<method name="get_object_id" qualifiers="const">
doc: Use self-closing tags for `return` and `argument` For the time being we don't support writing a description for those, preferring having all details in the method's description. Using self-closing tags saves half the lines, and prevents contributors from thinking that they should write the argument or return documentation there.
2021-07-30 13:28:05 +00:00
<return type="int" />
doc: Sync classref with StringName/Callable changes
2020-02-22 13:59:09 +00:00
<description>
Add LOTS of missing docs
2020-03-03 18:21:21 +00:00
Returns the ID of the object emitting this signal (see [method Object.get_instance_id]).
doc: Sync classref with StringName/Callable changes
2020-02-22 13:59:09 +00:00
</description>
</method>
doc: Sync classref with current source And move GLTF docs to its module folder.
2021-03-18 13:44:42 +00:00
<method name="is_connected" qualifiers="const">
doc: Use self-closing tags for `return` and `argument` For the time being we don't support writing a description for those, preferring having all details in the method's description. Using self-closing tags saves half the lines, and prevents contributors from thinking that they should write the argument or return documentation there.
2021-07-30 13:28:05 +00:00
<return type="bool" />
<argument index="0" name="callable" type="Callable" />
doc: Sync classref with StringName/Callable changes
2020-02-22 13:59:09 +00:00
<description>
Add LOTS of missing docs
2020-03-03 18:21:21 +00:00
Returns [code]true[/code] if the specified [Callable] is connected to this signal.
doc: Sync classref with StringName/Callable changes
2020-02-22 13:59:09 +00:00
</description>
</method>
doc: Sync classref with current source And move GLTF docs to its module folder.
2021-03-18 13:44:42 +00:00
<method name="is_null" qualifiers="const">
doc: Use self-closing tags for `return` and `argument` For the time being we don't support writing a description for those, preferring having all details in the method's description. Using self-closing tags saves half the lines, and prevents contributors from thinking that they should write the argument or return documentation there.
2021-07-30 13:28:05 +00:00
<return type="bool" />
doc: Sync classref with StringName/Callable changes
2020-02-22 13:59:09 +00:00
<description>
</description>
</method>
Move the docs for constructors and operators out of methods section
2021-09-21 02:49:02 +00:00
</methods>
<operators>
<operator name="operator !=">
Allow comparing equality between builtin types and null
2021-09-17 15:22:48 +00:00
<return type="bool" />
<description>
</description>
Move the docs for constructors and operators out of methods section
2021-09-21 02:49:02 +00:00
</operator>
<operator name="operator !=">
doc: Use self-closing tags for `return` and `argument` For the time being we don't support writing a description for those, preferring having all details in the method's description. Using self-closing tags saves half the lines, and prevents contributors from thinking that they should write the argument or return documentation there.
2021-07-30 13:28:05 +00:00
<return type="bool" />
<argument index="0" name="right" type="Signal" />
doc: Sync classref to add operators after #43419
2020-11-10 13:16:20 +00:00
<description>
</description>
Move the docs for constructors and operators out of methods section
2021-09-21 02:49:02 +00:00
</operator>
<operator name="operator ==">
Allow comparing equality between builtin types and null
2021-09-17 15:22:48 +00:00
<return type="bool" />
<description>
</description>
Move the docs for constructors and operators out of methods section
2021-09-21 02:49:02 +00:00
</operator>
<operator name="operator ==">
doc: Use self-closing tags for `return` and `argument` For the time being we don't support writing a description for those, preferring having all details in the method's description. Using self-closing tags saves half the lines, and prevents contributors from thinking that they should write the argument or return documentation there.
2021-07-30 13:28:05 +00:00
<return type="bool" />
<argument index="0" name="right" type="Signal" />
doc: Sync classref to add operators after #43419
2020-11-10 13:16:20 +00:00
<description>
</description>
Move the docs for constructors and operators out of methods section
2021-09-21 02:49:02 +00:00
</operator>
</operators>
doc: Sync classref with StringName/Callable changes
2020-02-22 13:59:09 +00:00
</class>