884360bc11
git-svn-id: https://svn.wxwidgets.org/svn/wx/wxWidgets/trunk@177 c3d73ce0-8a6f-49c7-b76d-6d57e0e08775
161 lines
4.7 KiB
TeX
161 lines
4.7 KiB
TeX
\section{\class{wxImageList}}\label{wximagelist}
|
|
|
|
A wxImageList contains a list of images, which are stored in
|
|
an unspecified form. Images can have masks for transparent
|
|
drawing, and can be made from a variety of sources including bitmaps
|
|
and icons.
|
|
|
|
wxImageList is used principally in conjunction with \helpref{wxTreeCtrl}{wxtreectrl} and
|
|
\rtfsp\helpref{wxListCtrl}{wxlistctrl} classes.
|
|
|
|
\wxheading{Derived from}
|
|
|
|
\helpref{wxObject}{wxobject}
|
|
|
|
\wxheading{See also}
|
|
|
|
\helpref{wxTreeCtrl}{wxtreectrl}, \helpref{wxListCtrl}{wxlistctrl}
|
|
|
|
\latexignore{\rtfignore{\wxheading{Members}}}
|
|
|
|
\membersection{wxImageList::wxImageList}\label{wximagelistconstr}
|
|
|
|
\func{}{wxImageList}{\void}
|
|
|
|
Default constructor.
|
|
|
|
\func{}{wxImageList}{\param{int }{width}, \param{int }{height}, \param{const bool }{mask = TRUE},\rtfsp
|
|
\param{int }{initialCount = 1}}
|
|
|
|
Constructor specifying the image size, whether image masks should be created, and the initial size of the list.
|
|
|
|
\wxheading{Parameters}
|
|
|
|
\docparam{width}{Width of the images in the list.}
|
|
|
|
\docparam{height}{Height of the images in the list.}
|
|
|
|
\docparam{mask}{TRUE if masks should be created for all images.}
|
|
|
|
\docparam{initialCount}{The initial size of the list.}
|
|
|
|
\wxheading{See also}
|
|
|
|
\helpref{wxImageList::Create}{wximagelistcreate}
|
|
|
|
\membersection{wxImageList::Add}\label{wximagelistadd}
|
|
|
|
\func{int}{Add}{\param{const wxBitmap\&}{ bitmap}, \param{const wxBitmap\&}{ mask = wxNullBitmap}}
|
|
|
|
Adds a new image using a bitmap and optional mask bitmap.
|
|
|
|
\func{int}{Add}{\param{const wxBitmap\&}{ bitmap}, \param{const wxColour\&}{ maskColour}}
|
|
|
|
Adds a new image using a bitmap and mask colour.
|
|
|
|
\func{int}{Add}{\param{const wxIcon\&}{ icon}}
|
|
|
|
Adds a new image using an icon.
|
|
|
|
\wxheading{Parameters}
|
|
|
|
\docparam{bitmap}{Bitmap representing the opaque areas of the image.}
|
|
|
|
\docparam{mask}{Monochrome mask bitmap, representing the transparent areas of the image.}
|
|
|
|
\docparam{maskColour}{Colour indicating which parts of the image are transparent.}
|
|
|
|
\docparam{icon}{Icon to use as the image.}
|
|
|
|
\wxheading{Return value}
|
|
|
|
The new zero-based image index.
|
|
|
|
\wxheading{Remarks}
|
|
|
|
The original bitmap or icon is not affected by the {\bf Add} operation, and can be deleted afterwards.
|
|
|
|
\membersection{wxImageList::Create}\label{wximagelistcreate}
|
|
|
|
\func{bool}{Create}{\param{int }{width}, \param{int }{height}, \param{const bool }{mask = TRUE},\rtfsp
|
|
\param{int }{initialCount = 1}}
|
|
|
|
Initializes the list. See \helpref{wxImageList::wxImageList}{wximagelistconstr} for details.
|
|
|
|
\membersection{wxImageList::Draw}\label{wximagelistdraw}
|
|
|
|
\func{bool}{Draw}{\param{int}{ index}, \param{wxDC\&}{ dc}, \param{int }{x},\rtfsp
|
|
\param{int }{x}, \param{int }{flags = wxIMAGELIST\_DRAW\_NORMAL},\rtfsp
|
|
\param{const bool }{solidBackground = FALSE}}
|
|
|
|
Draws a specified image onto a device context.
|
|
|
|
\wxheading{Parameters}
|
|
|
|
\docparam{index}{Image index, starting from zero.}
|
|
|
|
\docparam{dc}{Device context to draw on.}
|
|
|
|
\docparam{x}{X position on the device context.}
|
|
|
|
\docparam{y}{Y position on the device context.}
|
|
|
|
\docparam{flags}{How to draw the image. A bitlist of a selection of the following:
|
|
|
|
\begin{twocollist}\itemsep=0pt
|
|
\twocolitem{{\bf wxIMAGELIST\_DRAW\_NORMAL}}{Draw the image normally.}
|
|
\twocolitem{{\bf wxIMAGELIST\_DRAW\_TRANSPARENT}}{Draw the image with transparency.}
|
|
\twocolitem{{\bf wxIMAGELIST\_DRAW\_SELECTED}}{Draw the image in selected state.}
|
|
\twocolitem{{\bf wxIMAGELIST\_DRAW\_FOCUSED}}{Draw the image in a focussed state.}
|
|
\end{twocollist}
|
|
}
|
|
|
|
\docparam{solidBackground}{For optimisation - drawing can be faster if the function is told
|
|
that the background is solid.}
|
|
|
|
\membersection{wxImageList::GetImageCount}\label{wximagelistgetimagecount}
|
|
|
|
\constfunc{int}{GetImageCount}{\void}
|
|
|
|
Returns the number of images in the list.
|
|
|
|
\membersection{wxImageList::Remove}\label{wximagelistremove}
|
|
|
|
\func{bool}{Remove}{\param{int}{ index}}
|
|
|
|
Removes the image at the given position.
|
|
|
|
\membersection{wxImageList::RemoveAll}\label{wximagelistremoveall}
|
|
|
|
\func{bool}{RemoveAll}{\void}
|
|
|
|
Removes all the images in the list.
|
|
|
|
\membersection{wxImageList::Replace}\label{wximagelistreplace}
|
|
|
|
\func{bool}{Replace}{\param{int}{ index}, \param{const wxBitmap\&}{ bitmap}, \param{const wxBitmap\&}{ mask = wxNullBitmap}}
|
|
|
|
Replaces the existing image with the new image.
|
|
|
|
\func{bool}{Replace}{\param{int}{ index}, \param{const wxIcon\&}{ icon}}
|
|
|
|
Replaces the existing image with the new image.
|
|
|
|
\wxheading{Parameters}
|
|
|
|
\docparam{bitmap}{Bitmap representing the opaque areas of the image.}
|
|
|
|
\docparam{mask}{Monochrome mask bitmap, representing the transparent areas of the image.}
|
|
|
|
\docparam{icon}{Icon to use as the image.}
|
|
|
|
\wxheading{Return value}
|
|
|
|
TRUE if the replacement was successful, FALSE otherwise.
|
|
|
|
\wxheading{Remarks}
|
|
|
|
The original bitmap or icon is not affected by the {\bf Replace} operation, and can be deleted afterwards.
|
|
|
|
|