/////////////////////////////////////////////////////////////////////////////
// Name: imaglist.h
-// Purpose: documentation for wxImageList class
+// Purpose: interface of wxImageList
// Author: wxWidgets team
// RCS-ID: $Id$
// Licence: wxWindows license
@library{wxcore}
@category{gdi}
- @seealso
- wxTreeCtrl, wxListCtrl
+ @see wxTreeCtrl, wxListCtrl
*/
class wxImageList : public wxObject
{
/**
Constructor specifying the image size, whether image masks should be created,
and the initial size of the list.
-
+
@param width
Width of the images in the list.
@param height
@true if masks should be created for all images.
@param initialCount
The initial size of the list.
-
+
@see Create()
*/
wxImageList();
//@{
/**
Adds a new image using an icon.
-
+
@param bitmap
Bitmap representing the opaque areas of the image.
@param mask
Colour indicating which parts of the image are transparent.
@param icon
Icon to use as the image.
-
- @returns The new zero-based image index.
-
+
+ @return The new zero-based image index.
+
@remarks The original bitmap or icon is not affected by the Add
operation, and can be deleted afterwards.
*/
/**
Draws a specified image onto a device context.
-
+
@param index
Image index, starting from zero.
@param dc
Y position on the device context.
@param flags
How to draw the image. A bitlist of a selection of the following:
-
-
-
-
-
-
+
+
+
+
+
+
wxIMAGELIST_DRAW_NORMAL
-
-
-
-
+
+
+
+
Draw the image normally.
-
-
-
-
-
+
+
+
+
+
wxIMAGELIST_DRAW_TRANSPARENT
-
-
-
-
+
+
+
+
Draw the image with transparency.
-
-
-
-
-
+
+
+
+
+
wxIMAGELIST_DRAW_SELECTED
-
-
-
-
+
+
+
+
Draw the image in selected state.
-
-
-
-
-
+
+
+
+
+
wxIMAGELIST_DRAW_FOCUSED
-
-
-
-
+
+
+
+
Draw the image in a focused state.
@param solidBackground
For optimisation - drawing can be faster if the function is told
/**
Returns the bitmap corresponding to the given index.
*/
- wxBitmap GetBitmap(int index);
+ wxBitmap GetBitmap(int index) const;
/**
Returns the icon corresponding to the given index.
*/
- wxIcon GetIcon(int index);
+ wxIcon GetIcon(int index) const;
/**
Returns the number of images in the list.
*/
- int GetImageCount();
+ int GetImageCount() const;
/**
Retrieves the size of the images in the list. Currently, the @a index
parameter is ignored as all images in the list have the same size.
-
+
@param index
currently unused, should be 0
@param width
receives the width of the images in the list
@param height
receives the height of the images in the list
-
- @returns @true if the function succeeded, @false if it failed (for example,
+
+ @return @true if the function succeeded, @false if it failed (for example,
if the image list was not yet initialized).
*/
- bool GetSize(int index, int& width, int& height);
+ bool GetSize(int index, int& width, int& height) const;
/**
Removes the image at the given position.
//@{
/**
Replaces the existing image with the new image.
-
+
@param bitmap
Bitmap representing the opaque areas of the image.
@param mask
Monochrome mask bitmap, representing the transparent areas of the image.
@param icon
Icon to use as the image.
-
- @returns @true if the replacement was successful, @false otherwise.
-
+
+ @return @true if the replacement was successful, @false otherwise.
+
@remarks The original bitmap or icon is not affected by the Replace
operation, and can be deleted afterwards.
*/
bool Replace(int index, const wxIcon& icon);
//@}
};
+