From: Vadim Zeitlin <vadim@wxwidgets.org>
Date: Wed, 3 Mar 2010 01:08:19 +0000 (+0000)
Subject: Document that images in buttons and menus might not be shown under GTK.
X-Git-Url: https://git.saurik.com/wxWidgets.git/commitdiff_plain/b3f5fbf6ea79af16ca3bbe0305d13cb685785e95

Document that images in buttons and menus might not be shown under GTK.

Mention gtk-{button,menu}-images GTK+ settings.

See #11369.

git-svn-id: https://svn.wxwidgets.org/svn/wx/wxWidgets/trunk@63609 c3d73ce0-8a6f-49c7-b76d-6d57e0e08775
---

diff --git a/interface/wx/button.h b/interface/wx/button.h
index 4bbcd58518..9aad73ed38 100644
--- a/interface/wx/button.h
+++ b/interface/wx/button.h
@@ -83,6 +83,11 @@
     The position of the image inside the button be configured using
     SetBitmapPosition(). By default the image is on the left of the text.
 
+    Please also notice that GTK+ uses a global setting called @c
+    gtk-button-images to determine if the images should be shown in the buttons
+    at all. If it is off (which is the case in e.g. Gnome 2.28 by default), no
+    images will be shown, consistently with the native behaviour.
+
     @library{wxcore}
     @category{ctrl}
     @appearance{button.png}
diff --git a/interface/wx/menuitem.h b/interface/wx/menuitem.h
index da71be9190..b6c8cfdc32 100644
--- a/interface/wx/menuitem.h
+++ b/interface/wx/menuitem.h
@@ -314,6 +314,11 @@ public:
         @a checked is @true (default value) or SetBitmaps(wxNullBitmap, bmp)
         otherwise.
 
+        Notice that GTK+ uses a global setting called @c gtk-menu-images to
+        determine if the images should be shown in the menus at all. If it is
+        off (which is the case in e.g. Gnome 2.28 by default), no images will
+        be shown, consistently with the native behaviour.
+
         @onlyfor{wxmsw,wxosx,wxgtk}
     */
     virtual void SetBitmap(const wxBitmap& bmp, bool checked = true);