Deprecate widget flag: GTK_WIDGET_VISIBLE

[~andy/gtk] / gtk / gtkoffscreenwindow.c

diff --git a/gtk/gtkoffscreenwindow.c b/gtk/gtkoffscreenwindow.c
index fb6b9d90b70efda9b94601c713cedd419e5a3bb4..56cce55b7866d0dd76c7e2c92516a791bc6ac818 100644 (file)
--- a/gtk/gtkoffscreenwindow.c
+++ b/gtk/gtkoffscreenwindow.c
@@ -22,10 +22,10 @@
 #include "gtkalias.h"
 
 /**
- * SECTION:offscreen_windows
- * @short description: A toplevel container widget used to manage offscreen
+ * SECTION:gtkoffscreenwindow
+ * @short_description: A toplevel container widget used to manage offscreen
  *    rendering of child widgets.
- * @title: Offscreen windows
+ * @title: GtkOffscreenWindow
  *
  * #GtkOffscreenWindow is strictly intended to be used for obtaining
  * snapshots of widgets that are not part of a normal widget hierarchy.
@@ -35,8 +35,8 @@
  * is a toplevel widget you cannot obtain snapshots of a full window
  * with it since you cannot pack a toplevel widget in another toplevel.
  *
- * The idea is to take a widget and manually set the size and state of
- * it, add it to a #GtkOffscreenWindow and then retrieve the snapshot
+ * The idea is to take a widget and manually set the state of it,
+ * add it to a #GtkOffscreenWindow and then retrieve the snapshot
  * as a #GdkPixmap or #GdkPixbuf.
  *
  * #GtkOffscreenWindow derives from #GtkWindow only as an implementation
@@ -45,7 +45,7 @@
  * has no parent widget.
  *
  * When contained offscreen widgets are redrawn, #GtkOffscreenWindow
- * will emit a "damage-event" signal.
+ * will emit a #GtkWidget::damage-event signal.
  */
 
 G_DEFINE_TYPE (GtkOffscreenWindow, gtk_offscreen_window, GTK_TYPE_WINDOW);
@@ -63,7 +63,7 @@ gtk_offscreen_window_size_request (GtkWidget *widget,
   requisition->width = border_width * 2;
   requisition->height = border_width * 2;
 
-  if (bin->child && GTK_WIDGET_VISIBLE (bin->child))
+  if (bin->child && gtk_widget_get_visible (bin->child))
     {
       GtkRequisition child_req;
 
@@ -100,7 +100,7 @@ gtk_offscreen_window_size_allocate (GtkWidget *widget,
                             allocation->width,
                             allocation->height);
 
-  if (bin->child && GTK_WIDGET_VISIBLE (bin->child))
+  if (bin->child && gtk_widget_get_visible (bin->child))
     {
       GtkAllocation  child_alloc;
 
@@ -210,7 +210,7 @@ gtk_offscreen_window_check_resize (GtkContainer *container)
 {
   GtkWidget *widget = GTK_WIDGET (container);
 
-  if (GTK_WIDGET_VISIBLE (widget))
+  if (gtk_widget_get_visible (widget))
     gtk_offscreen_window_resize (widget);
 }
 
@@ -247,7 +247,9 @@ gtk_offscreen_window_init (GtkOffscreenWindow *window)
  * hierarchy, gtk_widget_get_snapshot() can be used instead.
  *
  * Return value: A pointer to a #GtkWidget
- **/
+ *
+ * Since: 2.20
+ */
 GtkWidget *
 gtk_offscreen_window_new (void)
 {
@@ -256,13 +258,16 @@ gtk_offscreen_window_new (void)
 
 /**
  * gtk_offscreen_window_get_pixmap:
+ * @offscreen: the #GtkOffscreenWindow contained widget.
  *
  * Retrieves a snapshot of the contained widget in the form of
  * a #GdkPixmap.  If you need to keep this around over window
  * resizes then you should add a reference to it.
  *
  * Returns: A #GdkPixmap pointer to the offscreen pixmap, or %NULL.
- **/
+ *
+ * Since: 2.20
+ */
 GdkPixmap *
 gtk_offscreen_window_get_pixmap (GtkOffscreenWindow *offscreen)
 {
@@ -273,6 +278,7 @@ gtk_offscreen_window_get_pixmap (GtkOffscreenWindow *offscreen)
 
 /**
  * gtk_offscreen_window_get_pixbuf:
+ * @offscreen: the #GtkOffscreenWindow contained widget.
  *
  * Retrieves a snapshot of the contained widget in the form of
  * a #GdkPixbuf.  This is a new pixbuf with a reference count of 1,
@@ -280,7 +286,9 @@ gtk_offscreen_window_get_pixmap (GtkOffscreenWindow *offscreen)
  * needed.
  *
  * Returns: A #GdkPixbuf pointer, or %NULL.
- **/
+ *
+ * Since: 2.20
+ */
 GdkPixbuf *
 gtk_offscreen_window_get_pixbuf (GtkOffscreenWindow *offscreen)
 {