diff --git a/docs/reference/gtk/event-handling.xml b/docs/reference/gtk/event-handling.xml new file mode 100644 index 0000000000..f1d673848e --- /dev/null +++ b/docs/reference/gtk/event-handling.xml @@ -0,0 +1,103 @@ + + +]> + + Event handling in GTK+ 3 + + + In version 3.6, GTK+ has overhauled the way widgets handle input events + considerably. The main motivation for this has been the more complex + interaction models used by modern toolkitts. In particular, enabling + all the behaviors people expect from multitouch support was guiding the + design. + + + + The principles outlined in this chapter are only relevant for people + that want to implement their own #GtkWidgets. It is not necessary that + you understand the concepts here when all you want to do is use existing + widgets to create your own application. + + +
+ The high-level view + + + FIXME + + + + The GTK event system is a cooperative event handling system. This means + that event recognizers need not know on their own if they should + recognize an event, but they communicate with other recognizers about + the process. + +
+ + +
+ Setting up your widget + +
+ Using GtkBuilder + + FIXME (with examples!) + +
+ +
+ Manual addition of event recognizers + + FIXME (with examples!) + +
+ +
+ + +
+ Event flow + +
+ Lifetime of a #GtkEventTracker + + FIXME + +
+ +
+ Flow of a #GdkEvent through the event machinery + + FIXME (make sure to not be too specific, so we can still change stuff later) + +
+ +
+ + +
+ Writing your own event recognizers + + + The GTK developers generally discourage the writing of new event recognizers. + We are trying to provide a consistent feel to GTK applications and with all + the included event recognizers we think almost all the functionality needed + for event handling should be there for you to use. + + Of course, every rule has its exceptions or you might just feel adventurous. + so should you see yourself in a situation where you need to write your own + event recognizers, here are some hints on how to do it. + + +
+ FIXME + + FIXME + +
+ +
+ + diff --git a/docs/reference/gtk/gtk-docs.sgml b/docs/reference/gtk/gtk-docs.sgml index 76881b170a..50a85f8ff1 100644 --- a/docs/reference/gtk/gtk-docs.sgml +++ b/docs/reference/gtk/gtk-docs.sgml @@ -271,6 +271,13 @@ + + Event handling + + + + + Printing