compilation fix for wxGetEmptyString() with wxUSE_STL == 1

[wxWidgets.git] / docs / latex / wx / artprov.tex

diff --git a/docs/latex/wx/artprov.tex b/docs/latex/wx/artprov.tex
index 87b135af6bfa255e923e691acc36010ec36148d2..dcee2933dae7e8cf38a5a6e430caf7068e171581 100644 (file)
--- a/docs/latex/wx/artprov.tex
+++ b/docs/latex/wx/artprov.tex
@@ -5,8 +5,8 @@
 
 \section{\class{wxArtProvider}}\label{wxartprovider}
 
-wxArtProvider class is used to customize the look of wxWindows application.
-When wxWindows need to display an icon or a bitmap (e.g. in the standard file
+wxArtProvider class is used to customize the look of wxWidgets application.
+When wxWidgets need to display an icon or a bitmap (e.g. in the standard file
 dialog), it does not use hard-coded resource but asks wxArtProvider for it
 instead. This way the users can plug in own wxArtProvider class and easily
 replace standard art with his/her own version. It is easy thing to do: all
@@ -32,7 +32,7 @@ There's another way of taking advantage of this class: you can use it in your co
 platform native icons as provided by
 \helpref{wxArtProvider::GetBitmap}{wxartprovidergetbitmap} or 
 \helpref{wxArtProvider::GetIcon}{wxartprovidergeticon} (NB: this is not yet really
-possible as of wxWindows 2.3.3, the set of wxArtProvider bitmaps is too
+possible as of wxWidgets 2.3.3, the set of wxArtProvider bitmaps is too
 small). 
 
 \membersection{Identifying art resources}
@@ -75,6 +75,20 @@ constants in the \helpref{artprov}{sampleartprovider} sample):
 \item wxART\_MISSING\_IMAGE      
 \end{itemize}
 
+Additionally, any string recognized by custom art providers registered using
+\helpref{PushProvider}{wxartproviderpushprovider} may be used.
+
+\wxheading{GTK+ Note}
+
+When running under GTK+ 2, GTK+ stock item IDs (e.g. {\tt "gtk-cdrom"}) may
+be used as well. Additionally, if wxGTK was compiled against GTK+ >= 2.4, then
+it is also possible to load icons from current icon theme by specifying their
+name (without extension and directory components). Icon themes recognized
+by GTK+ follow the
+\urlref{freedesktop.org Icon Themes specification}{http://freedesktop.org/Standards/icon-theme-spec}. Note that themes are not guaranteed to contain all
+icons, so wxArtProvider may return {\tt wxNullBitmap} or {\tt wxNullIcon}.
+Default theme is typically installed in {\tt /usr/share/icons/hicolor}.
+
 \membersection{Clients}
 
 Client is the entity that calls wxArtProvider's GetBitmap or GetIcon
@@ -83,6 +97,7 @@ values:
 \begin{itemize}\itemsep=0pt
 \item wxART\_TOOLBAR
 \item wxART\_MENU
+\item wxART\_BUTTON
 \item wxART\_FRAME\_ICON
 \item wxART\_CMN\_DIALOG
 \item wxART\_HELP\_BROWSER