Editing PlexyUI API (section)

== App lifecycle ==

These functions manage the lifetime of a PlexyDesk application object and its main loop.

=== <code>plexy_app_create</code> ===
<pre>PlexyApp* plexy_app_create(const char* name);</pre>
Create a top-level PlexyDesk application object.

==== Parameters ====
{| class="wikitable"
|-
! Parameter !! Type !! Description
|-
| <code>name</code> || <code>const char*</code> || Human-readable name used to identify the application.
|}

* '''Returns:''' A new <code>PlexyApp</code> handle.

=== <code>plexy_app_run</code> ===
<pre>void plexy_app_run(PlexyApp* app);</pre>
Enter the application event loop and keep the UI running until it exits.

==== Parameters ====
{| class="wikitable"
|-
! Parameter !! Type !! Description
|-
| <code>app</code> || <code>PlexyApp*</code> || Application handle that owns the operation.
|}

=== <code>plexy_app_quit</code> ===
<pre>void plexy_app_quit(PlexyApp* app);</pre>
Request that the application event loop stops.

==== Parameters ====
{| class="wikitable"
|-
! Parameter !! Type !! Description
|-
| <code>app</code> || <code>PlexyApp*</code> || Application handle that owns the operation.
|}

=== <code>plexy_app_destroy</code> ===
<pre>void plexy_app_destroy(PlexyApp* app);</pre>
Release the application object and its remaining resources.

==== Parameters ====
{| class="wikitable"
|-
! Parameter !! Type !! Description
|-
| <code>app</code> || <code>PlexyApp*</code> || Application handle that owns the operation.
|}