gtkmm r992 - in trunk: . gdk/src

[murrayc svn gnome org]

Author: murrayc
Date: Tue Apr 29 16:24:57 2008
New Revision: 992
URL: http://svn.gnome.org/viewvc/gtkmm?rev=992&view=rev

Log:
2008-04-29  Murray Cumming  <murrayc murrayc com>

* gdk/src/window.ccg:
* gdk/src/window.hg: Added unset_back_pixmap().
* gdk/src/gdk_docs_override.xml: Changed the back_pixmap() documentation 
to not mention NULL, and to refer to unset_back_pixmap().
This fixes bug #525967 (Jonathon Jongsma).

Modified:
   trunk/ChangeLog
   trunk/gdk/src/gdk_docs_override.xml
   trunk/gdk/src/window.ccg
   trunk/gdk/src/window.hg

Modified: trunk/gdk/src/gdk_docs_override.xml
==============================================================================
--- trunk/gdk/src/gdk_docs_override.xml	(original)
+++ trunk/gdk/src/gdk_docs_override.xml	Tue Apr 29 16:24:57 2008
@@ -602,4 +602,35 @@
 </return>
 </function>
 
+<function name="gdk_window_set_back_pixmap">
+<description>
+Sets the background pixmap of @window. 
+A background pixmap will be tiled, positioning the first tile at the origin of
+ window, or if @parent_relative is %TRUE, the tiling will be done based on the
+origin of the parent window (useful to align tiles in a parent with tiles
+in a child).
+
+The windowing system will normally fill a window with its background
+when the window is obscured then exposed, and when you call
+gdk_window_clear().
+
+See also unset_back_pixmap().
+</description>
+<parameters>
+<parameter name="window">
+<parameter_description> a #GdkWindow
+</parameter_description>
+</parameter>
+<parameter name="pixmap">
+<parameter_description> a #GdkPixmap
+</parameter_description>
+</parameter>
+<parameter name="parent_relative">
+<parameter_description> whether the tiling origin is at the origin of @window&apos;s parent
+</parameter_description>
+</parameter>
+</parameters>
+<return></return>
+</function>
+
 </root>

Modified: trunk/gdk/src/window.ccg
==============================================================================
--- trunk/gdk/src/window.ccg	(original)
+++ trunk/gdk/src/window.ccg	Tue Apr 29 16:24:57 2008
@@ -77,5 +77,10 @@
   real_drawable = Glib::wrap(temp_drawable);
 }
 
+void Window::unset_back_pixmap()
+{
+  gdk_window_set_back_pixmap(gobj(), NULL, FALSE);
+}
+
 } // namespace Gdk
 

Modified: trunk/gdk/src/window.hg
==============================================================================
--- trunk/gdk/src/window.hg	(original)
+++ trunk/gdk/src/window.hg	Tue Apr 29 16:24:57 2008
@@ -132,7 +132,17 @@
   _WRAP_METHOD(void set_startup_id(const Glib::ustring& startup_id), gdk_window_set_startup_id)
   _WRAP_METHOD(void set_transient_for(const Glib::RefPtr<Window>& parent), gdk_window_set_transient_for)
   _WRAP_METHOD(void set_background(const Color& color), gdk_window_set_background)
-  _WRAP_METHOD(void set_back_pixmap(const Glib::RefPtr<Pixmap>&pixmap, bool parent_relative), gdk_window_set_back_pixmap)
+  _WRAP_METHOD(void set_back_pixmap(const Glib::RefPtr<Pixmap>&pixmap, bool parent_relative = true), gdk_window_set_back_pixmap)
+
+  /** Unsets the background pixmap of @a window so that the window will have no
+   * background.  A window with no background will never have its
+   * background filled by the windowing system, instead the window will
+   * contain whatever pixels were already in the corresponding area of
+   * the display.
+   *
+   * @see set_back_pixmap().
+   */
+  void unset_back_pixmap();
 
 #m4 _CONVERSION(const Cursor&,GdkCursor*,const_cast<GdkCursor*>(($3).gobj()))
   _WRAP_METHOD(void set_cursor(const Cursor& cursor), gdk_window_set_cursor)