Constructor
GtkApplicationnew
Declaration [src]
GtkApplication*
gtk_application_new (
const char* application_id,
GApplicationFlags flags
)
Description [src]
Creates a new GtkApplication
instance.
When using GtkApplication
, it is not necessary to call gtk_init()
manually. It is called as soon as the application gets registered as
the primary instance.
Concretely, gtk_init()
is called in the default handler for the
GApplication::startup
signal. Therefore, GtkApplication
subclasses should
always chain up in their GApplication::startup
handler before using any GTK
API.
Note that commandline arguments are not passed to gtk_init()
.
If application_id
is not NULL
, then it must be valid. See
g_application_id_is_valid()
.
If no application ID is given then some features (most notably application uniqueness) will be disabled.
Parameters
application_id |
const char* |
The application ID. |
|
The argument can be NULL . | |
The data is owned by the caller of the function. | |
The value is a NUL terminated UTF-8 string. | |
flags |
GApplicationFlags |
The application flags. |
Return value
Returns: | GtkApplication |
A new |
|
The caller of the function takes ownership of the data, and is responsible for freeing it. |