X-Git-Url: https://git.saurik.com/wxWidgets.git/blobdiff_plain/12f5e1e78fe906050ff2fee9529476db332633f0..058f225a44d83d42ba9d773efc705badbf0e5e3c:/interface/wx/iconbndl.h diff --git a/interface/wx/iconbndl.h b/interface/wx/iconbndl.h index 7b2d3265a6..9e35cc0dde 100644 --- a/interface/wx/iconbndl.h +++ b/interface/wx/iconbndl.h @@ -9,12 +9,11 @@ /** @class wxIconBundle - This class contains multiple copies of an icon in different sizes, - see also wxDialog::SetIcons and - wxTopLevelWindow::SetIcons. + This class contains multiple copies of an icon in different sizes. + It is typically used in wxDialog::SetIcons and wxTopLevelWindow::SetIcons. @library{wxcore} - @category{FIXME} + @category{gdi} @stdobjects ::wxNullIconBundle @@ -22,61 +21,87 @@ class wxIconBundle : public wxGDIObject { public: - //@{ /** - Copy constructor. + Default ctor. */ wxIconBundle(); + + /** + Initializes the bundle with the icon(s) found in the file. + */ wxIconBundle(const wxString& file, wxBitmapType type); + + /** + Initializes the bundle with a single icon. + */ wxIconBundle(const wxIcon& icon); + + /** + Copy constructor. + */ wxIconBundle(const wxIconBundle& ic); - //@} /** Destructor. */ - ~wxIconBundle(); + virtual ~wxIconBundle(); + + /** + Adds all the icons contained in the file to the bundle; if the collection + already contains icons with the same width and height, they are replaced + by the new ones. + */ + void AddIcon(const wxString& file, wxBitmapType type); - //@{ /** Adds the icon to the collection; if the collection already contains an icon with the same width and height, it is replaced by the new one. */ - void AddIcon(const wxString& file, wxBitmapType type); void AddIcon(const wxIcon& icon); - //@} - //@{ /** - Same as GetIcon( wxSize( size, size ) ). + Returns the icon with the given size; if no such icon exists, returns + the icon with size @c wxSYS_ICON_X and @c wxSYS_ICON_Y; if no such icon + exists, returns the first icon in the bundle. + + If size = wxDefaultSize, returns the icon with size @c wxSYS_ICON_X and + @c wxSYS_ICON_Y. */ wxIcon GetIcon(const wxSize& size) const; - const wxIcon GetIcon(wxCoord size = -1) const; - //@} /** - Returns the icon with exactly the given size or @c wxNullIcon if this + Same as @code GetIcon( wxSize( size, size ) ) @endcode. + */ + wxIcon GetIcon(wxCoord size = wxDefaultCoord) const; + + /** + Returns the icon with exactly the given size or ::wxNullIcon if this size is not available. */ wxIcon GetIconOfExactSize(const wxSize& size) const; /** - Returns @true if the bundle doesn't contain any icons, @false otherwise (in - which case a call to GetIcon() with default - parameter should return a valid icon). + Returns @true if the bundle doesn't contain any icons, @false otherwise + (in which case a call to GetIcon() with default parameter should return + a valid icon). */ bool IsEmpty() const; /** - Assignment operator, using @ref overview_trefcount "reference counting". + Assignment operator, using @ref overview_refcount "reference counting". */ - wxIconBundle operator =(const wxIconBundle& ic); + wxIconBundle& operator=(const wxIconBundle& ic); /** Equality operator. This returns @true if two icon bundles are equal. */ bool operator ==(const wxIconBundle& ic); + + /** + Inequality operator. This returns true if two icon bundles are not equal. + */ + bool operator !=(const wxIconBundle& ic); };