abb33bd65f
The introspection data does not handle unattached sections like gtk-doc does, so we need to move what was gtkmain into its own Markdown document.
2.2 KiB
| Title |
|---|
| Initialization |
Library initialization and main loop
Before using GTK, you need to initialize it using [func@Gtk.init]; this
connects to the windowing system, sets up the locale and performs other
initialization tasks. [func@Gtk.init] exits the application if errors occur;
to avoid this, you can use [func@Gtk.init_check], which allows you to recover
from a failed GTK initialization; for instance, you might start up your
application in text mode instead.
Like most GUI toolkits, GTK uses an event-driven programming model. When the application is doing nothing, GTK sits in the “main loop” and waits for input. If the user performs some action - say, a mouse click - then the main loop “wakes up” and delivers an event to GTK. GTK forwards the event to one or more widgets.
When widgets receive an event, they frequently emit one or more “signals”.
Signals notify your program that "something interesting happened" by invoking
functions you’ve connected to the signal with g_signal_connect(). Functions
connected to a signal are often called “callbacks”.
When your callbacks are invoked, you would typically take some action - for example, when an Open button is clicked you might display a [class@Gtk.FileChooserDialog]. After a callback finishes, GTK will return to the main loop and await more user input.
The main() function for a simple GTK application
int
main (int argc, char **argv)
{
GtkWidget *window;
// Initialize i18n support with bindtextdomain(), etc.
// ...
// Initialize the widget set
gtk_init ();
// Create the main window
window = gtk_window_new ();
// Set up our GUI elements
// ...
// Show the application window
gtk_widget_show (window);
// Enter the main event loop, and wait for user interaction
while (!done)
g_main_context_iteration (NULL, TRUE);
// The user lost interest
return 0;
}
It's important to note that if you use [class@Gtk.Application], the application class will take care of initializing GTK for you, as well as spinning the main loop.
See also
- the GLib manual, especially
GMainLoop - signal-related functions, such as
g_signal_connect()in GObject