|
@@ -7,18 +7,28 @@ Quitting
|
|
|
--------
|
|
|
|
|
|
Most platforms have the option to request the application to quit. On
|
|
|
-desktops, this is usually done with the "x" icon on the window titlebar.
|
|
|
+desktops, this is usually done with the "x" icon on the window title bar.
|
|
|
On Android, the back button is used to quit when on the main screen (and
|
|
|
to go back otherwise).
|
|
|
|
|
|
Handling the notification
|
|
|
-------------------------
|
|
|
|
|
|
-The :ref:`MainLoop <class_MainLoop>`
|
|
|
-has a special notification that is sent to all nodes when quit is
|
|
|
-requested: MainLoop.NOTIFICATION_WM_QUIT.
|
|
|
+On desktop platforms, the :ref:`MainLoop <class_MainLoop>`
|
|
|
+has a special ``MainLoop.NOTIFICATION_WM_QUIT_REQUEST`` notification that is
|
|
|
+sent to all nodes when quitting is requested.
|
|
|
|
|
|
-Handling it is done as follows (on any node):
|
|
|
+On Android, ``MainLoop.NOTIFICATION_WM_GO_BACK_REQUEST`` is sent instead.
|
|
|
+Pressing the Back button will exit the application if
|
|
|
+**Application > Config > Quit On Go Back** is checked in the Project Settings
|
|
|
+(which is the default).
|
|
|
+
|
|
|
+.. note::
|
|
|
+
|
|
|
+ ``MainLoop.NOTIFICATION_WM_GO_BACK_REQUEST`` isn't supported on iOS, as
|
|
|
+ iOS devices don't have a physical Back button.
|
|
|
+
|
|
|
+Handling the notification is done as follows (on any node):
|
|
|
|
|
|
.. tabs::
|
|
|
.. code-tab:: gdscript GDScript
|