summaryrefslogtreecommitdiff
path: root/docs
diff options
context:
space:
mode:
authorMatthias Clasen <mclasen@redhat.com>2020-04-09 17:29:48 -0400
committerMatthias Clasen <mclasen@redhat.com>2020-04-09 18:26:31 -0400
commitf16c8291907b523ce3a809623b0a67366c3e4039 (patch)
treef4ea01ab380419fefc9082b84a7715bcb07bdcd7 /docs
parent16c820c2f05dfa83d4a2ec0f84e55ebf106ca628 (diff)
downloadgtk+-f16c8291907b523ce3a809623b0a67366c3e4039.tar.gz
Mention focus changes in the migration guide
Diffstat (limited to 'docs')
-rw-r--r--docs/reference/gtk/migrating-3to4.xml16
1 files changed, 16 insertions, 0 deletions
diff --git a/docs/reference/gtk/migrating-3to4.xml b/docs/reference/gtk/migrating-3to4.xml
index 634fcbe71d..570bdca0d7 100644
--- a/docs/reference/gtk/migrating-3to4.xml
+++ b/docs/reference/gtk/migrating-3to4.xml
@@ -471,6 +471,22 @@
</section>
<section>
+ <title>Focus handling changes</title>
+ <para>
+ The semantics of the #GtkWidget:can-focus property have changed.
+ In GTK 3, this property only meant that the widget itself would not
+ accept keyboard input, but its children still might (in the case of
+ containers). In GTK 4, if :can-focus is %FALSE, the focus cannot enter
+ the widget or any of its descendents, and the default value has changed
+ from %FALSE to %TRUE.
+ </para>
+ <para>
+ The recommended way to influence focus behavior of custom widgets
+ in GTK 4 is to override the focus() and grab_focus() vfuncs.
+ </para>
+ </section>
+
+ <section>
<title>Stop using GtkEventBox</title>
<para>
GtkEventBox is no longer needed and has been removed.