X-Git-Url: https://git.saurik.com/wxWidgets.git/blobdiff_plain/ae3c17b4013e80b99976c750c19fca47729517f6..92c0fc34c104c8d7c12d6a3b78ea232690fc23f4:/interface/wx/statbmp.h

diff --git a/interface/wx/statbmp.h b/interface/wx/statbmp.h
index d18ff1fe39..c1e75089ee 100644
--- a/interface/wx/statbmp.h
+++ b/interface/wx/statbmp.h
@@ -2,24 +2,29 @@
 // Name:        statbmp.h
 // Purpose:     interface of wxStaticBitmap
 // Author:      wxWidgets team
-// RCS-ID:      $Id$
-// Licence:     wxWindows license
+// Licence:     wxWindows licence
 /////////////////////////////////////////////////////////////////////////////
 
 /**
     @class wxStaticBitmap
-    @wxheader{statbmp.h}
 
-    A static bitmap control displays a bitmap. Native implementations on some 
-    platforms are only meant for display of the small icons in the dialog 
+    A static bitmap control displays a bitmap. Native implementations on some
+    platforms are only meant for display of the small icons in the dialog
     boxes. In particular, under Windows 9x the size of bitmap is limited
     to 64*64 pixels.
-    If you want to display larger images portably, you may use generic 
-    implementation wxGenericStaticBitmap declared in <wx/generic/statbmpg.h>.
+
+    If you want to display larger images portably, you may use generic
+    implementation wxGenericStaticBitmap declared in \<wx/generic/statbmpg.h\>.
+
+    Notice that for the best results, the size of the control should be the
+    same as the size of the image displayed in it, as happens by default if
+    if it's not resized explicitly. Otherwise, behaviour depends on the
+    platform: under MSW, the bitmap is drawn centred inside the control, while
+    elsewhere it is drawn at the origin of the control.
 
     @library{wxcore}
     @category{ctrl}
-    <!-- @appearance{staticbitmap.png} -->
+    @appearance{staticbitmap}
 
     @see wxStaticBitmap, wxStaticBox
 */
@@ -30,7 +35,7 @@ public:
       Default constructor
     */
     wxStaticBitmap();
-    
+
     /**
         Constructor, creating and showing a static bitmap control.
 
@@ -56,35 +61,33 @@ public:
                    const wxPoint& pos = wxDefaultPosition,
                    const wxSize& size = wxDefaultSize,
                    long style = 0,
-                   const wxString& name = "staticBitmap");
+                   const wxString& name = wxStaticBitmapNameStr);
 
     /**
         Creation function, for two-step construction. For details see wxStaticBitmap().
     */
-    bool Create(wxWindow* parent, wxWindowID id,
-                const wxBitmap& label,
+    bool Create(wxWindow* parent, wxWindowID id, const wxBitmap& label,
                 const wxPoint& pos = wxDefaultPosition,
-                const wxSize& size = wxDefaultSize,
-                long style = 0,
-                const wxString& name = "staticBitmap");
+                const wxSize& size = wxDefaultSize, long style = 0,
+                const wxString& name = wxStaticBitmapNameStr);
 
     /**
-        Returns the bitmap currently used in the control. Notice that this method can
-        be called even if SetIcon() had been used.
+        Returns the bitmap currently used in the control.
+        Notice that this method can be called even if SetIcon() had been used.
 
         @see SetBitmap()
     */
-    wxBitmap GetBitmap() const;
+    virtual wxBitmap GetBitmap() const;
 
     /**
-        Returns the icon currently used in the control. Notice that this method can
-        only be called if SetIcon() had been used: an icon
-        can't be retrieved from the control if a bitmap had been set (using
-        wxStaticBitmap::SetBitmap).
+        Returns the icon currently used in the control.
+        Notice that this method can only be called if SetIcon() had been used: an icon
+        can't be retrieved from the control if a bitmap had been set
+        (using wxStaticBitmap::SetBitmap).
 
         @see SetIcon()
     */
-    wxIcon GetIcon() const;
+    virtual wxIcon GetIcon() const;
 
     /**
         Sets the bitmap label.