After an evaluation, GNOME has moved from Bugzilla to GitLab. Learn more about GitLab.
No new issues can be reported in GNOME Bugzilla anymore.
To report an issue in a GNOME project, go to GNOME GitLab.
Do not go to GNOME Gitlab for: Bluefish, Doxygen, GnuCash, GStreamer, java-gnome, LDTP, NetworkManager, Tomboy.
Bug 525967 - Documentation for Gdk::Window::set_back_pixmap not customized for gtkmm
Documentation for Gdk::Window::set_back_pixmap not customized for gtkmm
Status: RESOLVED FIXED
Product: gtkmm
Classification: Bindings
Component: documentation
unspecified
Other Windows
: Normal normal
: ---
Assigned To: gtkmm-forge
Depends on:
Blocks:
 
 
Reported: 2008-04-03 14:13 UTC by Jonathon Jongsma
Modified: 2015-11-25 16:15 UTC
See Also:
GNOME target: ---
GNOME version: ---


Description Jonathon Jongsma 2008-04-03 14:13:01 UTC 
The documentation says "A background pixmap of 0 means that the window will have no background. "  But this doesn't really apply since the parameter is a RefPtr and not a raw pointer.
Comment 1 Murray Cumming 2008-04-03 14:38:29 UTC 
We would usually add an overload for this, such as unset_back_pixmap(). We can do that in svn trunk.

In the meantime, people should use
  gdk_window_set_back_pixmap(window->gobj(), NULL, parent_relative)
Comment 2 Jonathon Jongsma 2008-04-03 14:44:40 UTC 
I'm fairly sure it will work to just pass an empty refptr to this function since internally it uses Glib::unwrap(pixmap), which does a check to see if the refptr is valid and if not, returns 0, else returns refptr->gobj()
Comment 3 Murray Cumming 2008-04-03 15:04:54 UTC 
That's lucky.
Comment 4 Jonathon Jongsma 2008-04-03 15:15:45 UTC 
yes, it would definitely be more natural to have an unset_* method, so we should probably add that anyway, even if the thing I mentioned above does actually work.
Comment 5 Murray Cumming 2008-04-29 16:25:14 UTC 
Fixed in svn trunk:

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).