[gtk+] gtk: Remove gdk_window_invalidate() from docs



commit 1df8b1571169924e97b783692106b93a6564c8b0
Author: Benjamin Otte <otte redhat com>
Date:   Wed Oct 19 22:33:26 2016 +0200

    gtk: Remove gdk_window_invalidate() from docs
    
    And replace its mentions with gtk_widget_queue_draw().

 gtk/gtkmain.c   |    2 +-
 gtk/gtkwidget.c |   12 ++++++------
 2 files changed, 7 insertions(+), 7 deletions(-)
---
diff --git a/gtk/gtkmain.c b/gtk/gtkmain.c
index 7a476ae..854938c 100644
--- a/gtk/gtkmain.c
+++ b/gtk/gtkmain.c
@@ -2562,7 +2562,7 @@ propagate_event (GtkWidget *widget,
  * All that said, you most likely don’t want to use any of these
  * functions; synthesizing events is rarely needed. There are almost
  * certainly better ways to achieve your goals. For example, use
- * gdk_window_invalidate_rect() or gtk_widget_queue_draw() instead
+ * gtk_widget_queue_draw() instead
  * of making up expose events.
  */
 void
diff --git a/gtk/gtkwidget.c b/gtk/gtkwidget.c
index 8613e9c..a815230 100644
--- a/gtk/gtkwidget.c
+++ b/gtk/gtkwidget.c
@@ -5086,11 +5086,11 @@ gtk_widget_real_queue_draw_region (GtkWidget            *widget,
  * @widget: a #GtkWidget
  * @region: region to draw
  *
- * Invalidates the area of @widget defined by @region by calling
- * gdk_window_invalidate_region() on the widget’s window and all its
- * child windows. Once the main loop becomes idle (after the current
- * batch of events has been processed, roughly), the window will
- * receive expose events for the union of all regions that have been
+ * Invalidates the area of @widget defined by @region by notifying
+ * the parent via its GtkWidgetClass::queue_draw_child() function.
+ * Once the main loop becomes idle (after the current batch of
+ * events has been processed, roughly), the window will receive
+ * expose events for the union of all regions that have been
  * invalidated.
  *
  * Normally you would only use this function in widget
@@ -6771,7 +6771,7 @@ gtk_widget_real_grab_broken_event (GtkWidget          *widget,
  * If you want to synthesize an event though, don’t use this function;
  * instead, use gtk_main_do_event() so the event will behave as if
  * it were in the event queue. Don’t synthesize expose events; instead,
- * use gdk_window_invalidate_rect() to invalidate a region of the
+ * use gtk_widget_queue_draw_region() to invalidate a region of the
  * window.
  *
  * Returns: return from the event signal emission (%TRUE if


[Date Prev][Date Next]   [Thread Prev][Thread Next]   [Thread Index] [Date Index] [Author Index]