X-Git-Url: https://git.saurik.com/wxWidgets.git/blobdiff_plain/a582395301f296706dc9e59d0346cddd165eacd8..6da8eee196a81d1626391916b6119f3c6ee63ad8:/docs/tech/tn0015.txt diff --git a/docs/tech/tn0015.txt b/docs/tech/tn0015.txt index 4929e7d44a..167fc35735 100644 --- a/docs/tech/tn0015.txt +++ b/docs/tech/tn0015.txt @@ -1,4 +1,4 @@ - How to add new bitmaps to wxWindows UI elements + How to add new bitmaps to wxWidgets UI elements =============================================== 0. Introduction @@ -10,7 +10,7 @@ code. This was previously done either by including the bitmap in win32 resource file (include/wx/msw/wx.rc) or by including XPM files in the code. wxArtProvider should be used instead, to allow users to customize the look of -their wxWindows app. This technote is a detailed description of steps needed +their wxWidgets app. This technote is a detailed description of steps needed when adding new bitmap/icon. 1. Adding new resource @@ -21,14 +21,16 @@ when adding new bitmap/icon. First of all, you have to add new wxArtID constant to include/wx/artprov.h. Look for "Art IDs" and add new definition to the list, e.g. - #define wxART_MY_BITMAP _T("my_bitmap") + #define wxART_MY_BITMAP wxART_MAKE_ART_ID(wxART_MY_BITMAP) + +Add it to docs/latex/wx/artprov.tex, too. It may happen that the intended use of the new resource doesn't fit into any of defined client categories (search for "Art clients" in the header). In case the new resource is part of a larger category, you need to define a new -client. Just add it to the list of existing clients: - #define wxART_MY_CLIENT _T("my_client_C") -(Note that you *have* to add the trailing "_C"!) +client. Just add it to the list of existing clients (and don't forget to +update artprov.tex): + #define wxART_MY_CLIENT wxART_MAKE_CLIENT_ID(wxART_MY_CLIENT) Alternatively, you may use wxART_OTHER when accessing the resource if the bitmap is standalone. @@ -75,10 +77,10 @@ client is wxART_OTHER you may write only ------------------- It is highly desirable to let the users know what stock bitmaps are available -in wxWindows. The "artprov" sample serves this purpose: it contains a browser +in wxWidgets. The "artprov" sample serves this purpose: it contains a browser dialog that displays all available art resources. -It has to be updated to accomodate for new bitmaps. Fortunately, this is +It has to be updated to accommodate for new bitmaps. Fortunately, this is trivial: open $(wx)/samples/artprov/artbrows.cpp in text editor and ART_ICON(wxART_MY_BITMAP) line to the FillBitmaps() function.