docs/latex/wx/imaglist.tex

   1 \section{\class{wxImageList}}\label{wximagelist}
   2
   3 A wxImageList contains a list of images, which are stored in
   4 an unspecified form. Images can have masks for transparent
   5 drawing, and can be made from a variety of sources including bitmaps
   6 and icons.
   7
   8 wxImageList is used principally in conjunction with \helpref{wxTreeCtrl}{wxtreectrl} and
   9 \rtfsp\helpref{wxListCtrl}{wxlistctrl} classes.
  10
  11 \wxheading{Derived from}
  12
  13 \helpref{wxObject}{wxobject}
  14
  15 \wxheading{Include files}
  16
  17 <wx/imaglist.h>
  18
  19 \wxheading{See also}
  20
  21 \helpref{wxTreeCtrl}{wxtreectrl}, \helpref{wxListCtrl}{wxlistctrl}
  22
  23 \latexignore{\rtfignore{\wxheading{Members}}}
  24
  25 \membersection{wxImageList::wxImageList}\label{wximagelistconstr}
  26
  27 \func{}{wxImageList}{\void}
  28
  29 Default constructor.
  30
  31 \func{}{wxImageList}{\param{int }{width}, \param{int }{height}, \param{const bool }{mask = TRUE},\rtfsp
  32 \param{int }{initialCount = 1}}
  33
  34 Constructor specifying the image size, whether image masks should be created, and the initial size of the list.
  35
  36 \wxheading{Parameters}
  37
  38 \docparam{width}{Width of the images in the list.}
  39
  40 \docparam{height}{Height of the images in the list.}
  41
  42 \docparam{mask}{TRUE if masks should be created for all images.}
  43
  44 \docparam{initialCount}{The initial size of the list.}
  45
  46 \wxheading{See also}
  47
  48 \helpref{wxImageList::Create}{wximagelistcreate}
  49
  50 \membersection{wxImageList::Add}\label{wximagelistadd}
  51
  52 \func{int}{Add}{\param{const wxBitmap\&}{ bitmap}, \param{const wxBitmap\&}{ mask = wxNullBitmap}}
  53
  54 Adds a new image using a bitmap and optional mask bitmap.
  55
  56 \func{int}{Add}{\param{const wxBitmap\&}{ bitmap}, \param{const wxColour\&}{ maskColour}}
  57
  58 Adds a new image using a bitmap and mask colour.
  59
  60 \func{int}{Add}{\param{const wxIcon\&}{ icon}}
  61
  62 Adds a new image using an icon.
  63
  64 \wxheading{Parameters}
  65
  66 \docparam{bitmap}{Bitmap representing the opaque areas of the image.}
  67
  68 \docparam{mask}{Monochrome mask bitmap, representing the transparent areas of the image.}
  69
  70 \docparam{maskColour}{Colour indicating which parts of the image are transparent.}
  71
  72 \docparam{icon}{Icon to use as the image.}
  73
  74 \wxheading{Return value}
  75
  76 The new zero-based image index.
  77
  78 \wxheading{Remarks}
  79
  80 The original bitmap or icon is not affected by the {\bf Add} operation, and can be deleted afterwards.
  81
  82 \pythonnote{In place of a single overloaded method name, wxPython
  83 implements the following methods:\par
  84 \indented{2cm}{\begin{twocollist}
  85 \twocolitem{{\bf Add(bitmap, mask=wxNullBitmap)}}{}
  86 \twocolitem{{\bf AddWithColourMask(bitmap, colour)}}{}
  87 \twocolitem{{\bf AddIcon(icon)}}{}
  88 \end{twocollist}}
  89 }
  90 \membersection{wxImageList::Create}\label{wximagelistcreate}
  91
  92 \func{bool}{Create}{\param{int }{width}, \param{int }{height}, \param{const bool }{mask = TRUE},\rtfsp
  93 \param{int }{initialCount = 1}}
  94
  95 Initializes the list. See \helpref{wxImageList::wxImageList}{wximagelistconstr} for details.
  96
  97 \membersection{wxImageList::Draw}\label{wximagelistdraw}
  98
  99 \func{bool}{Draw}{\param{int}{ index}, \param{wxDC\&}{ dc}, \param{int }{x},\rtfsp
 100 \param{int }{x}, \param{int }{flags = wxIMAGELIST\_DRAW\_NORMAL},\rtfsp
 101 \param{const bool }{solidBackground = FALSE}}
 102
 103 Draws a specified image onto a device context.
 104
 105 \wxheading{Parameters}
 106
 107 \docparam{index}{Image index, starting from zero.}
 108
 109 \docparam{dc}{Device context to draw on.}
 110
 111 \docparam{x}{X position on the device context.}
 112
 113 \docparam{y}{Y position on the device context.}
 114
 115 \docparam{flags}{How to draw the image. A bitlist of a selection of the following:
 116
 117 \begin{twocollist}\itemsep=0pt
 118 \twocolitem{{\bf wxIMAGELIST\_DRAW\_NORMAL}}{Draw the image normally.}
 119 \twocolitem{{\bf wxIMAGELIST\_DRAW\_TRANSPARENT}}{Draw the image with transparency.}
 120 \twocolitem{{\bf wxIMAGELIST\_DRAW\_SELECTED}}{Draw the image in selected state.}
 121 \twocolitem{{\bf wxIMAGELIST\_DRAW\_FOCUSED}}{Draw the image in a focused state.}
 122 \end{twocollist}
 123 }
 124
 125 \docparam{solidBackground}{For optimisation - drawing can be faster if the function is told
 126 that the background is solid.}
 127
 128 \membersection{wxImageList::GetImageCount}\label{wximagelistgetimagecount}
 129
 130 \constfunc{int}{GetImageCount}{\void}
 131
 132 Returns the number of images in the list.
 133
 134 \membersection{wxImageList::GetSize}\label{wximagelistgetsize}
 135
 136 \constfunc{bool}{GetSize}{\param{int }{index}, \param{int\& }{width}, \param{int \&}{height}}
 137
 138 Retrieves the size of the images in the list. Currently, the {\it index}
 139 parameter is ignored as all images in the list have the same size.
 140
 141 \wxheading{Parameters}
 142
 143 \docparam{index}{currently unused, should be 0}
 144
 145 \docparam{width}{receives the width of the images in the list}
 146
 147 \docparam{height}{receives the height of the images in the list}
 148
 149 \wxheading{Return value}
 150
 151 TRUE if the function succeeded, FALSE if it failed (for example, if the image
 152 list was not yet initialized).
 153
 154 \membersection{wxImageList::Remove}\label{wximagelistremove}
 155
 156 \func{bool}{Remove}{\param{int}{ index}}
 157
 158 Removes the image at the given position.
 159
 160 \membersection{wxImageList::RemoveAll}\label{wximagelistremoveall}
 161
 162 \func{bool}{RemoveAll}{\void}
 163
 164 Removes all the images in the list.
 165
 166 \membersection{wxImageList::Replace}\label{wximagelistreplace}
 167
 168 \func{bool}{Replace}{\param{int}{ index}, \param{const wxBitmap\&}{ bitmap}, \param{const wxBitmap\&}{ mask = wxNullBitmap}}
 169
 170 Replaces the existing image with the new image.
 171
 172 \func{bool}{Replace}{\param{int}{ index}, \param{const wxIcon\&}{ icon}}
 173
 174 Replaces the existing image with the new image.
 175
 176 \wxheading{Parameters}
 177
 178 \docparam{bitmap}{Bitmap representing the opaque areas of the image.}
 179
 180 \docparam{mask}{Monochrome mask bitmap, representing the transparent areas of the image.}
 181
 182 \docparam{icon}{Icon to use as the image.}
 183
 184 \wxheading{Return value}
 185
 186 TRUE if the replacement was successful, FALSE otherwise.
 187
 188 \wxheading{Remarks}
 189
 190 The original bitmap or icon is not affected by the {\bf Replace} operation, and can be deleted afterwards.
 191
 192 \pythonnote{The second form is called {\tt ReplaceIcon} in wxPython.}
 193
 194