wx.lib.agw.thumbnailctrl.ThumbnailCtrl

ThumbnailCtrl is a widget that can be used to display a series of images in a “thumbnail” format.

Class Hierarchy

Inheritance diagram for class ThumbnailCtrl:

Control Appearance

wxMSW

wxMAC

wxGTK

Known Superclasses

wx.Panel

Methods Summary

__init__	Default class constructor.
GetShowComboBox	Returns whether the folder combobox is shown.
OnComboBox	Handles the wx.EVT_COMBOBOX for the folder combobox.
RecreateComboBox	Recreates the folder combobox every time a new directory is explored.
ShowComboBox	Shows/Hide the top folder ComboBox.

Class API

class ThumbnailCtrl(wx.Panel)

ThumbnailCtrl is a widget that can be used to display a series of images in a “thumbnail” format.

Methods

__init__(self, parent, id=wx.ID_ANY, pos=wx.DefaultPosition, size=wx.DefaultSize, thumboutline=THUMB_OUTLINE_IMAGE, thumbfilter=THUMB_FILTER_IMAGES, imagehandler=PILImageHandler)

Default class constructor.

Parameters

• parent – parent window. Must not be None;

• id – window identifier. A value of -1 indicates a default value;

• pos – the control position. A value of (-1, -1) indicates a default position, chosen by either the windowing system or wxPython, depending on platform;

• size – the control size. A value of (-1, -1) indicates a default size, chosen by either the windowing system or wxPython, depending on platform;

• thumboutline – outline style for ThumbnailCtrl, which may be:

  Outline Flag	Value	Description
  THUMB_OUTLINE_NONE	0	No outline is drawn on selection
  THUMB_OUTLINE_FULL	1	Full outline (image+caption) is drawn on selection
  THUMB_OUTLINE_RECT	2	Only thumbnail bounding rectangle is drawn on selection (default)
  THUMB_OUTLINE_IMAGE	4	Only image bounding rectangle is drawn.

• thumbfilter – filter for image/video/audio files. Actually only THUMB_FILTER_IMAGES is implemented;

• imagehandler – can be PILImageHandler if PIL is installed (faster), or NativeImageHandler which only uses wxPython image methods.

---

GetShowComboBox(self)

Returns whether the folder combobox is shown.

---

OnComboBox(self, event)

Handles the wx.EVT_COMBOBOX for the folder combobox.

Parameters

event – a CommandEvent event to be processed.

---

RecreateComboBox(self, newdir)

Recreates the folder combobox every time a new directory is explored.

Parameters

newdir – the new folder to be explored.

---

ShowComboBox(self, show=True)

Shows/Hide the top folder ComboBox.

Parameters

show – True to show the combobox, False otherwise.