init


Description:

public void init (ref string[]? argv)

Call this function before using any other GTK+ functions in your GUI applications.

It will initialize everything needed to operate the toolkit and parses some standard command line options.

Although you are expected to pass the argv.length, argv parameters from main to this function, it is possible to pass null if argv is not available or commandline handling is not required.

argv.length and argv are adjusted accordingly so your own code will never see those standard arguments.

Note that there are some alternative ways to initialize GTK+: if you are calling parse_args, init_check, init_with_args or parse with the option group returned by get_option_group, you don’t have to call init.

And if you are using Application, you don't have to call any of the initialization functions either; the startup handler does it for you.

This function will terminate your program if it was unable to initialize the windowing system for some reason. If you want your program to fall back to a textual interface you want to call init_check instead.

Since 2.18, GTK+ calls `signal (SIGPIPE, SIG_IGN)` during initialization, to ignore SIGPIPE signals, since these are almost never wanted in graphical applications. If you do need to handle SIGPIPE for some reason, reset the handler after init, but notice that other libraries (e.g. libdbus or gvfs) might do similar things.

Parameters:

argv

Address of the `argv` parameter of main, or null. Any options understood by GTK+ are stripped before return.

argc

Address of the `argc` parameter of your main function (or 0 if argv is null) . This will be changed if any arguments were handled.


Namespace: Gtk
Package: gtk+-3.0