From 5acee3a3e054f25e73e2027269e5f51efe41af7d Mon Sep 17 00:00:00 2001 From: Daniel Boles Date: Thu, 3 Aug 2017 10:13:52 +0100 Subject: [PATCH] Layout: Tweak documentation blurb Being addable to a ScrolledWindow is not interesting; now that SW auto-adds a Viewport if needed, so can DrawingArea and any other widget. Mention GtkFixed in case the reader just wants that bit of functionality --- gtk/gtklayout.c | 19 ++++++++++--------- 1 file changed, 10 insertions(+), 9 deletions(-) diff --git a/gtk/gtklayout.c b/gtk/gtklayout.c index 26b74f2981..0abc988130 100644 --- a/gtk/gtklayout.c +++ b/gtk/gtklayout.c @@ -44,19 +44,20 @@ * @Short_description: Infinite scrollable area containing child widgets * and/or custom drawing * @Title: GtkLayout - * @See_also: #GtkDrawingArea, #GtkScrolledWindow + * @See_also: #GtkDrawingArea, #GtkFixed * - * #GtkLayout is similar to #GtkDrawingArea in that it’s a “blank slate” - * and doesn’t do anything but paint a blank background by default. It's - * different in that it supports scrolling natively (you can add it to a - * #GtkScrolledWindow), and it can contain child widgets, since it’s a - * #GtkContainer. However if you’re just going to draw, a #GtkDrawingArea - * is a better choice since it has lower overhead. + * #GtkLayout is similar to #GtkDrawingArea in that it’s a “blank slate” and + * doesn’t do anything except paint a blank background by default. It’s + * different in that it supports scrolling natively due to implementing + * #GtkScrollable, and can contain child widgets since it’s a #GtkContainer. + * + * If you just want to draw, a #GtkDrawingArea is a better choice since it has + * lower overhead. If you just need to position child widgets at specific + * points, then #GtkFixed provides that functionality on its own. * * When handling expose events on a #GtkLayout, you must draw to * GTK_LAYOUT (layout)->bin_window, rather than to - * GTK_WIDGET (layout)->window, as you would for a drawing - * area. + * GTK_WIDGET (layout)->window, as you would for a #GtkDrawingArea. */