summaryrefslogtreecommitdiff
path: root/gtk/gtkwidget.c
diff options
context:
space:
mode:
authorMatthias Clasen <mclasen@redhat.com>2005-06-11 05:51:55 +0000
committerMatthias Clasen <matthiasc@src.gnome.org>2005-06-11 05:51:55 +0000
commit8cc74c39114528578c4f618a7f40d7f417218a58 (patch)
tree6c55065898d35ceba39d26feae25905829cb726a /gtk/gtkwidget.c
parent0dcce7e40c60dec9fabf0d6f1c158a4025e703c5 (diff)
downloadgdk-pixbuf-8cc74c39114528578c4f618a7f40d7f417218a58.tar.gz
More docs provided by Owen Taylor.
2005-06-11 Matthias Clasen <mclasen@redhat.com> * gtk/gtkwidget.c (gtk_widget_set_app_paintable): More docs provided by Owen Taylor.
Diffstat (limited to 'gtk/gtkwidget.c')
-rw-r--r--gtk/gtkwidget.c12
1 files changed, 9 insertions, 3 deletions
diff --git a/gtk/gtkwidget.c b/gtk/gtkwidget.c
index d61046eb0..200678923 100644
--- a/gtk/gtkwidget.c
+++ b/gtk/gtkwidget.c
@@ -4270,9 +4270,15 @@ gtk_widget_set_state (GtkWidget *widget,
* @widget: a #GtkWidget
* @app_paintable: %TRUE if the application will paint on the widget
*
- * Sets the app-paintable property to indicate to the widget that the
- * application intends to paint directly on the widget.
- *
+ * Sets whether the application intends to draw on the widget in
+ * an ::expose-event handler.
+ *
+ * This is a hint to the widget and does not affect the behavior of
+ * the GTK+ core; many widgets ignore this flag entirely. For widgets
+ * that do pay attention to the flag, such as #GtkEventBox and #GtkWindow,
+ * the effect is to suppress default themed drawing of the widget's
+ * background. (Children of the widget will still be drawn.) The application
+ * is then entirely responsible for drawing the widget background.
**/
void
gtk_widget_set_app_paintable (GtkWidget *widget,