Clarify notification call order

This commit is contained in:
kobewi 2025-11-11 13:59:10 +01:00
parent 8327dfa215
commit 1be1bd15d8
5 changed files with 6 additions and 1 deletions

View file

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

View file

@ -1287,6 +1287,7 @@
</constant> </constant>
<constant name="NOTIFICATION_FOCUS_EXIT" value="44"> <constant name="NOTIFICATION_FOCUS_EXIT" value="44">
Sent when the node loses focus. Sent when the node loses focus.
This notification is sent in reversed order.
</constant> </constant>
<constant name="NOTIFICATION_THEME_CHANGED" value="45"> <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: 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"> <constant name="NOTIFICATION_EXIT_TREE" value="11">
Notification received when the node is about to exit a [SceneTree]. See [method _exit_tree]. 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 received [i]after[/i] the related [signal tree_exiting] signal.
This notification is sent in reversed order.
</constant> </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 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> </constant>

View file

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

View file

@ -267,7 +267,7 @@
[/csharp] [/csharp]
[/codeblocks] [/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] 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> </description>
</method> </method>
<method name="_property_can_revert" qualifiers="virtual"> <method name="_property_can_revert" qualifiers="virtual">
@ -1031,6 +1031,7 @@
</constant> </constant>
<constant name="NOTIFICATION_PREDELETE" value="1"> <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. 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>
<constant name="NOTIFICATION_EXTENSION_RELOADED" value="2"> <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. Notification received when the object finishes hot reloading. This notification is only sent for extensions classes and derived.