Gtk2::main

NAME
METHODS
ENUMS AND FLAGS
- flags Gtk2::Gdk::ModifierType
SEE ALSO
COPYRIGHT

METHODS

boolean = Gtk2->alternative_dialog_button_order ($screen=undef)

$screen (Gtk2::Gdk::Screen or undef)

Since: gtk+ 2.6

event or undef = Gtk2->get_current_event

modifiertype = Gtk2->get_current_event_state

unsigned = Gtk2->get_current_event_time

language = Gtk2->get_default_language

widget or undef = Gtk2->get_event_widget ($event)

$event (Gtk2::Gdk::Event or undef)

integer = Gtk2->events_pending

widget or undef = Gtk2->grab_get_current

Initialize Gtk+. This must be called before any other Gtk2 functions in a GUI application; the Gtk2 module's import method allows you to pass -init in the use statement to do this automatically. This function also scans @ARGV for any options it knows, and will remove them automagically.

Note: this function will terminate your program if it is unable to initialize the gui for any reason. If you want your program to fall back to some other interface, you want to use Gtk2->init_check instead.

boolean = Gtk2->init_check

This is the non-fatal version of Gtk2->init; instead of calling exit if Gtk+ initialization fails, Gtk2->init_check returns false. This allows your application to fall back on some other means of communication with the user - for example a curses or command-line interface.

integer = Gtk2->key_snooper_install ($snooper, $func_data=undef)

$snooper (subroutine) function to call on every event
$func_data (scalar)

Install a key "snooper" function which will get called on all key events before those events are delivered normally. These snoopers can be used to implement custom key event handling.

key_snooper_install returns an id that may be used with key_snooper_remove (below). snooper is called as

    stopbool = &snooper ($widget, $event, $func_data);

It should return true to stop event propagation, the same as Gtk2::Widget event signal handlers. The Gtk2::EVENT_STOP and Gtk2::EVENT_PROPAGATE constants can be used for the return (see Gtk2::Widget).

Gtk2->key_snooper_remove ($snooper_handler_id)

$snooper_handler_id (integer)

string = Gtk2->set_locale

Gtk2->main

Gtk2->main_do_event ($event)

$event (Gtk2::Gdk::Event)

This is the event handler that GTK+ registers with GDK. GTK+ exposes it to allow filtering of events between GDK and GTK+; it is rare that you would need this, except if you are using Gtk2::Gdk::Event::handler_set.