Merge pull request #112642 from KoBeWi/multiple_levels_of_wrong

Clarify notification call order
This commit is contained in:
Thaddeus Crews
2025-11-11 10:37:33 -06:00
5 changed files with 6 additions and 1 deletions

View File

@ -753,6 +753,7 @@
</constant>
<constant name="NOTIFICATION_EXIT_CANVAS" value="33">
The [CanvasItem] has exited the canvas.
This notification is sent in reversed order.
</constant>
<constant name="NOTIFICATION_WORLD_2D_CHANGED" value="36">
Notification received when this [CanvasItem] is registered to a new [World2D] (see [method get_world_2d]).

View File

@ -1287,6 +1287,7 @@
</constant>
<constant name="NOTIFICATION_FOCUS_EXIT" value="44">
Sent when the node loses focus.
This notification is sent in reversed order.
</constant>
<constant name="NOTIFICATION_THEME_CHANGED" value="45">
Sent when the node needs to refresh its theme items. This happens in one of the following cases:

View File

@ -1165,6 +1165,7 @@
<constant name="NOTIFICATION_EXIT_TREE" value="11">
Notification received when the node is about to exit a [SceneTree]. See [method _exit_tree].
This notification is received [i]after[/i] the related [signal tree_exiting] signal.
This notification is sent in reversed order.
</constant>
<constant name="NOTIFICATION_MOVED_IN_PARENT" value="12" deprecated="This notification is no longer sent by the engine. Use [constant NOTIFICATION_CHILD_ORDER_CHANGED] instead.">
</constant>

View File

@ -380,6 +380,7 @@
</constant>
<constant name="NOTIFICATION_EXIT_WORLD" value="42">
Notification received when this node is unregistered from the current [World3D] (see [method get_world_3d]).
This notification is sent in reversed order.
</constant>
<constant name="NOTIFICATION_VISIBILITY_CHANGED" value="43">
Notification received when this node's visibility changes (see [member visible] and [method is_visible_in_tree]).

View File

@ -267,7 +267,7 @@
[/csharp]
[/codeblocks]
[b]Note:[/b] The base [Object] defines a few notifications ([constant NOTIFICATION_POSTINITIALIZE] and [constant NOTIFICATION_PREDELETE]). Inheriting classes such as [Node] define a lot more notifications, which are also received by this method.
[b]Note:[/b] Unlike other virtual methods, this method is called automatically for every script that overrides it. This means that the base implementation should not be called via [code]super[/code] in GDScript or its equivalents in other languages. The bottom-most sub-class will be called first, with subsequent calls ascending the class hierarchy.
[b]Note:[/b] Unlike other virtual methods, this method is called automatically for every script that overrides it. This means that the base implementation should not be called via [code]super[/code] in GDScript or its equivalents in other languages. Call order depends on the [code]reversed[/code] argument of [method notification] and varies between different notifications. Most notifications are sent in the forward order (i.e. Object class first, most derived class last).
</description>
</method>
<method name="_property_can_revert" qualifiers="virtual">
@ -1031,6 +1031,7 @@
</constant>
<constant name="NOTIFICATION_PREDELETE" value="1">
Notification received when the object is about to be deleted. Can be used like destructors in object-oriented programming languages.
This notification is sent in reversed order.
</constant>
<constant name="NOTIFICATION_EXTENSION_RELOADED" value="2">
Notification received when the object finishes hot reloading. This notification is only sent for extensions classes and derived.