X-Git-Url: https://git.saurik.com/wxWidgets.git/blobdiff_plain/ae3c17b4013e80b99976c750c19fca47729517f6..157a8f700278715161c66a418124459a6dc501dc:/interface/wx/bitmap.h diff --git a/interface/wx/bitmap.h b/interface/wx/bitmap.h index 1bcf959e19..68c3ed8bc5 100644 --- a/interface/wx/bitmap.h +++ b/interface/wx/bitmap.h @@ -14,7 +14,6 @@ /** @class wxBitmapHandler - @wxheader{bitmap.h} This is the base class for implementing bitmap file loading/saving, and bitmap creation from data. @@ -24,6 +23,11 @@ wxBitmapHandler and add the handler using wxBitmap::AddHandler() in your application initialisation. + Note that all wxBitmapHandlers provided by wxWidgets are part of the + @ref page_libs_wxcore library. + For details about the default handlers, please see the note in the + wxBitmap class documentation. + @library{wxcore} @category{misc} @@ -154,11 +158,10 @@ public: /** @class wxBitmap - @wxheader{bitmap.h} This class encapsulates the concept of a platform-dependent bitmap, either monochrome or colour or colour with alpha channel support. - + If you need direct access the bitmap data instead going through drawing to it using wxMemoryDC you need to use the wxPixelData class (either wxNativePixelData for RGB bitmaps or wxAlphaPixelData @@ -281,10 +284,13 @@ public: @param type May be one of the ::wxBitmapType values and indicates which type of bitmap should be loaded. See the note in the class detailed description. + Note that the wxBITMAP_DEFAULT_TYPE constant has different value under + different wxWidgets ports. See the bitmap.h header for the value it takes + for a specific port. @see LoadFile() */ - wxBitmap(const wxString& name, wxBitmapType type = wxBITMAP_TYPE_XPM); + wxBitmap(const wxString& name, wxBitmapType type = wxBITMAP_DEFAULT_TYPE); /** Creates this bitmap object from the given image. @@ -491,7 +497,7 @@ public: /** Returns @true if bitmap data is present. */ - bool IsOk() const; + virtual bool IsOk() const; /** Loads a bitmap from a file or resource. @@ -502,6 +508,9 @@ public: @param type One of the ::wxBitmapType values; see the note in the class detailed description. + Note that the wxBITMAP_DEFAULT_TYPE constant has different value under + different wxWidgets ports. See the bitmap.h header for the value it takes + for a specific port. @return @true if the operation succeeded, @false otherwise. @@ -512,7 +521,7 @@ public: @see SaveFile() */ - virtual bool LoadFile(const wxString& name, wxBitmapType type); + virtual bool LoadFile(const wxString& name, wxBitmapType type = wxBITMAP_DEFAULT_TYPE); /** Finds the handler with the given name, and removes it. @@ -605,7 +614,6 @@ wxBitmap wxNullBitmap; /** @class wxMask - @wxheader{bitmap.h} This class encapsulates a monochrome mask bitmap, where the masked area is black and the unmasked area is white.