X-Git-Url: https://git.saurik.com/wxWidgets.git/blobdiff_plain/ea11bf3abcec34e31b9919a2e222e61f82643830..ab7f0034828cfc121014b3e1e29bba583fb6d832:/interface/wx/bannerwindow.h

diff --git a/interface/wx/bannerwindow.h b/interface/wx/bannerwindow.h
index 50f70bb3b7..4cf80741c5 100644
--- a/interface/wx/bannerwindow.h
+++ b/interface/wx/bannerwindow.h
@@ -1,5 +1,5 @@
 ///////////////////////////////////////////////////////////////////////////////
-// Name:        interface.wx/bannerwindow.h
+// Name:        interface/wx/bannerwindow.h
 // Purpose:     wxBannerWindow class documentation
 // Author:      Vadim Zeitlin
 // Created:     2011-08-16
@@ -113,14 +113,20 @@ public:
     /**
         Provide the bitmap to use as background.
 
-        Notice that the bitmap should be big enough to always cover the entire
-        banner, e.g. for a horizontal banner with wxTOP style its width should
-        be bigger than any reasonable window size.
-
-        For wxLEFT orientation the bitmap is truncated from the top, for wxTOP
-        and wxBOTTOM -- from the right and for wxRIGHT -- from the bottom, so
-        put the most important part of the bitmap information in the opposite
-        direction.
+        Notice that ideally the bitmap should be big enough to always cover the
+        entire banner, e.g. for a horizontal banner with wxTOP style its width
+        should be bigger than any reasonable window size. Otherwise the bitmap
+        is extended to cover the entire window area with a solid colour taken
+        from the bitmap pixel on the edge in which direction the extension
+        occurs so all bitmap pixels on this edge (top for wxLEFT, right for
+        wxTOP and wxBOTTOM and bottom for wxRIGHT) should have the same colour
+        to avoid jarring discontinuity.
+
+        If, on the other hand, the bitmap is bigger than the window size, then
+        it is truncated. For wxLEFT orientation the bitmap is truncated from
+        the top, for wxTOP and wxBOTTOM -- from the right and for wxRIGHT --
+        from the bottom, so put the most important part of the bitmap
+        information in the opposite direction where it will never be truncated.
 
         If no valid background bitmap is specified, the banner draws gradient
         background but if a valid bitmap is given here, the gradient is not