From 92a95c7de73f56fe558323e2012d6d6e2ddf2eb0 Mon Sep 17 00:00:00 2001 From: Philip Withnall Date: Mon, 22 Aug 2016 17:10:47 +0100 Subject: [PATCH] gtkbindings: Clarify that widgets need has-focus for bindings to work https://bugzilla.gnome.org/show_bug.cgi?id=770242 --- gtk/gtkbindings.c | 6 ++++++ 1 file changed, 6 insertions(+) diff --git a/gtk/gtkbindings.c b/gtk/gtkbindings.c index 54515d3e0d..f71fcac335 100644 --- a/gtk/gtkbindings.c +++ b/gtk/gtkbindings.c @@ -47,6 +47,12 @@ * with high key binding configurability which requires no application * or toolkit side changes. * + * In order for bindings to work in a custom widget implementation, the + * widget’s #GtkWidget:can-focus and #GtkWidget:has-focus properties + * must both be true. For example, by calling gtk_widget_set_can_focus() + * in the widget’s initialisation function; and by calling + * gtk_widget_grab_focus() when the widget is clicked. + * * # Installing a key binding * * A CSS file binding consists of a “binding-set” definition and a match