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 4bbcd5851849635268906db25df8ae33c808d7c6..9aad73ed38519311acf36a7557de786beb5ef6d4 100644 (file)
--- 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 da71be9190dab3b11efa55a2030f26a922e4051b..b6c8cfdc32708f69d7b2cd2ca3d3ab60e1d2c43e 100644 (file)
--- 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);