phoenix_title wx.lib.agw.ultimatelistctrl.PyImageList

A PyImageList contains a list of images. Images can have masks for transparent drawing, and can be made from a variety of sources including bitmaps and icons.

PyImageList is used in conjunction with UltimateListCtrl.

Note

The main improvements that PyImageList introduces is the removal of the limitation of same-size images inside the image list. If you use the style IL_VARIABLE_SIZE then each image can have any size (in terms of width and height).


class_hierarchy Class Hierarchy

Inheritance diagram for class PyImageList:

method_summary Methods Summary

__init__

Default class constructor.

Add

Adds a new image or images using a bitmap.

AddIcon

Adds a new image using an icon.

AddWithColourMask

Adds a new image or images using a bitmap and a colour mask.

Draw

Draws a specified image onto a device context.

GetBitmap

Returns the bitmap corresponding to the given index, or NullBitmap

GetIcon

Returns the icon corresponding to the given index, or NullIcon

GetImageCount

Returns the number of images in the list.

GetSize

Retrieves the size of an image in the list.

Remove

Removes the image at the given position.

RemoveAll

Removes all the images in the list.

Replace

Replaces the existing image with the new bitmap.

ReplaceIcon

Replaces the existing image with the new icon.


api Class API

class PyImageList(object)

A PyImageList contains a list of images. Images can have masks for transparent drawing, and can be made from a variety of sources including bitmaps and icons.

PyImageList is used in conjunction with UltimateListCtrl.

Note

The main improvements that PyImageList introduces is the removal of the limitation of same-size images inside the image list. If you use the style IL_VARIABLE_SIZE then each image can have any size (in terms of width and height).


Methods

__init__(self, width, height, mask=True, initialCount=1, style=IL_VARIABLE_SIZE)

Default class constructor.

Parameters:
  • width – the width of the images in the image list, in pixels (unused if you specify the IL_VARIABLE_SIZE style;

  • height – the height of the images in the image list, in pixels (unused if you specify the IL_VARIABLE_SIZE style;

  • maskTrue if masks should be created for all images (unused in PyImageList);

  • initialCount – the initial size of the list (unused in PyImageList);

  • style – can be one of the following bits:

    Style Flag

    Value

    Description

    IL_FIXED_SIZE

    0

    All the images in PyImageList have the same size (width, height)

    IL_VARIABLE_SIZE

    1

    Each image can have any size (in terms of width and height)



Add(self, bitmap)

Adds a new image or images using a bitmap.

Parameters:

bitmap – a valid wx.Bitmap object.

Returns:

The new zero-based image index.

Note

If the bitmap is wider than the images in the list and you are not using the IL_VARIABLE_SIZE style, then the bitmap will automatically be split into smaller images, each matching the dimensions of the image list.



AddIcon(self, icon)

Adds a new image using an icon.

Parameters:

icon – a valid Icon object.

Returns:

The new zero-based image index.

Note

If the icon is wider than the images in the list and you are not using the IL_VARIABLE_SIZE style, then the icon will automatically be split into smaller images, each matching the dimensions of the image list.



AddWithColourMask(self, bitmap, maskColour)

Adds a new image or images using a bitmap and a colour mask.

Parameters:
  • bitmap – a valid wx.Bitmap object;

  • colour – an instance of wx.Colour, a colour indicating which parts of the image are transparent.

Returns:

The new zero-based image index.

Note

If the bitmap is wider than the images in the list and you are not using the IL_VARIABLE_SIZE style, then the bitmap will automatically be split into smaller images, each matching the dimensions of the image list.



Draw(self, index, dc, x, y, flags, solidBackground=True)

Draws a specified image onto a device context.

Parameters:
  • index – the image index, starting from zero;

  • dc – an instance of wx.DC;

  • x – x position on the device context;

  • y – y position on the device context;

  • flags – how to draw the image. A bitlist of a selection of the following:

    Flag Paarameter

    Description

    wx.IMAGELIST_DRAW_NORMAL

    Draw the image normally

    wx.IMAGELIST_DRAW_TRANSPARENT

    Draw the image with transparency

    wx.IMAGELIST_DRAW_SELECTED

    Draw the image in selected state

    wx.IMAGELIST_DRAW_FOCUSED

    Draw the image in a focused state

  • solidBackground – currently unused.



GetBitmap(self, index)

Returns the bitmap corresponding to the given index, or NullBitmap if the index is invalid.

Parameters:

index – the bitmap index.



GetIcon(self, index)

Returns the icon corresponding to the given index, or NullIcon if the index is invalid.

Parameters:

index – the icon index.



GetImageCount(self)

Returns the number of images in the list.



GetSize(self, index)

Retrieves the size of an image in the list.

Parameters:

index – the zero-based index of the image.

Returns:

a tuple of (width, height) properties of the chosen bitmap.



Remove(self, index)

Removes the image at the given position.

Parameters:

index – the zero-based index of the image to be removed.



RemoveAll(self)

Removes all the images in the list.



Replace(self, index, bitmap)

Replaces the existing image with the new bitmap.

Parameters:
  • index – the index at which the image should be replaced;

  • bitmap – the new bitmap to add to the image list, an instance of wx.Bitmap.



ReplaceIcon(self, index, icon)

Replaces the existing image with the new icon.

Parameters:
  • index – the index at which the image should be replaced;

  • icon – the new icon to add to the image list, an instance of Icon.