summaryrefslogtreecommitdiff
diff options
context:
space:
mode:
authorMatthias Clasen <mclasen@redhat.com>2021-04-16 11:14:18 -0400
committerMatthias Clasen <mclasen@redhat.com>2021-04-16 11:15:05 -0400
commit3aa742d715b5860099f07bb5600110623f666950 (patch)
tree8fc508ba78aea8a8791d63b562c6d0e3243b158c
parenta1aa4a970d6eb3468cffe8e6fc7e2a7ac3e4bc6a (diff)
downloadgtk+-3aa742d715b5860099f07bb5600110623f666950.tar.gz
overlay: Clarify pass-through docs
Explain that widgets with their own windows need to have gdk_window_set_pass_through called on them. Fixes: #3861
-rw-r--r--gtk/gtkoverlay.c5
1 files changed, 5 insertions, 0 deletions
diff --git a/gtk/gtkoverlay.c b/gtk/gtkoverlay.c
index 8dcaaf0ab7..ae27021663 100644
--- a/gtk/gtkoverlay.c
+++ b/gtk/gtkoverlay.c
@@ -777,6 +777,11 @@ gtk_overlay_class_init (GtkOverlayClass *klass)
* Whether to pass input through the overlay child to the main child.
* (Of course, this has no effect when set on the main child itself.)
*
+ * Note that this is implemented by calling gdk_window_set_pass_through()
+ * on the window that the overlay child is placed in. If the descendents
+ * of the overlay child have their own windows, you need to manually call
+ * that function on them to achieve the desired effect.
+ *
* Since: 3.18
*/
gtk_container_class_install_child_property (container_class, CHILD_PROP_PASS_THROUGH,