wxPython-zombie 3.1.5.8__cp313-cp313-win_amd64.whl

wx/demo/ListCtrl.py

@@ -0,0 +1,538 @@
+#!/usr/bin/env python
+
+#----------------------------------------------------------------------------
+# Name:         ListCtrl.py
+# Purpose:      Testing lots of stuff, controls, window types, etc.
+#
+# Author:       Robin Dunn & Gary Dumer
+#
+# Created:
+# Copyright:    (c) 1998-2020 by Total Control Software
+# Licence:      wxWindows license
+#----------------------------------------------------------------------------
+
+import sys
+import wx
+import wx.lib.mixins.listctrl as listmix
+
+import images
+
+#---------------------------------------------------------------------------
+
+musicdata = {
+1 : ("Bad English", "The Price Of Love", "Rock"),
+2 : ("DNA featuring Suzanne Vega", "Tom's Diner", "Rock"),
+3 : ("George Michael", "Praying For Time", "Rock"),
+4 : ("Gloria Estefan", "Here We Are", "Rock"),
+5 : ("Linda Ronstadt", "Don't Know Much", "Rock"),
+6 : ("Michael Bolton", "How Am I Supposed To Live Without You", "Blues"),
+7 : ("Paul Young", "Oh Girl", "Rock"),
+8 : ("Paula Abdul", "Opposites Attract", "Rock"),
+9 : ("Richard Marx", "Should've Known Better", "Rock"),
+10: ("Rod Stewart", "Forever Young", "Rock"),
+11: ("Roxette", "Dangerous", "Rock"),
+12: ("Sheena Easton", "The Lover In Me", "Rock"),
+13: ("Sinead O'Connor", "Nothing Compares 2 U", "Rock"),
+14: ("Stevie B.", "Because I Love You", "Rock"),
+15: ("Taylor Dayne", "Love Will Lead You Back", "Rock"),
+16: ("The Bangles", "Eternal Flame", "Rock"),
+17: ("Wilson Phillips", "Release Me", "Rock"),
+18: ("Billy Joel", "Blonde Over Blue", "Rock"),
+19: ("Billy Joel", "Famous Last Words", "Rock"),
+20: ("Janet Jackson", "State Of The World", "Rock"),
+21: ("Janet Jackson", "The Knowledge", "Rock"),
+22: ("Spyro Gyra", "End of Romanticism", "Jazz"),
+23: ("Spyro Gyra", "Heliopolis", "Jazz"),
+24: ("Spyro Gyra", "Jubilee", "Jazz"),
+25: ("Spyro Gyra", "Little Linda", "Jazz"),
+26: ("Spyro Gyra", "Morning Dance", "Jazz"),
+27: ("Spyro Gyra", "Song for Lorraine", "Jazz"),
+28: ("Yes", "Owner Of A Lonely Heart", "Rock"),
+29: ("Yes", "Rhythm Of Love", "Rock"),
+30: ("Billy Joel", "Lullabye (Goodnight, My Angel)", "Rock"),
+31: ("Billy Joel", "The River Of Dreams", "Rock"),
+32: ("Billy Joel", "Two Thousand Years", "Rock"),
+33: ("Janet Jackson", "Alright", "Rock"),
+34: ("Janet Jackson", "Black Cat", "Rock"),
+35: ("Janet Jackson", "Come Back To Me", "Rock"),
+36: ("Janet Jackson", "Escapade", "Rock"),
+37: ("Janet Jackson", "Love Will Never Do (Without You)", "Rock"),
+38: ("Janet Jackson", "Miss You Much", "Rock"),
+39: ("Janet Jackson", "Rhythm Nation", "Rock"),
+40: ("Cusco", "Dream Catcher", "New Age"),
+41: ("Cusco", "Geronimos Laughter", "New Age"),
+42: ("Cusco", "Ghost Dance", "New Age"),
+43: ("Blue Man Group", "Drumbone", "New Age"),
+44: ("Blue Man Group", "Endless Column", "New Age"),
+45: ("Blue Man Group", "Klein Mandelbrot", "New Age"),
+46: ("Kenny G", "Silhouette", "Jazz"),
+47: ("Sade", "Smooth Operator", "Jazz"),
+48: ("David Arkenstone", "Papillon (On The Wings Of The Butterfly)", "New Age"),
+49: ("David Arkenstone", "Stepping Stars", "New Age"),
+50: ("David Arkenstone", "Carnation Lily Lily Rose", "New Age"),
+51: ("David Lanz", "Behind The Waterfall", "New Age"),
+52: ("David Lanz", "Cristofori's Dream", "New Age"),
+53: ("David Lanz", "Heartsounds", "New Age"),
+54: ("David Lanz", "Leaves on the Seine", "New Age"),
+}
+
+#---------------------------------------------------------------------------
+
+class TestListCtrl(wx.ListCtrl, listmix.ListCtrlAutoWidthMixin):
+    def __init__(self, parent, ID, pos=wx.DefaultPosition,
+                 size=wx.DefaultSize, style=0):
+        wx.ListCtrl.__init__(self, parent, ID, pos, size, style)
+        listmix.ListCtrlAutoWidthMixin.__init__(self)
+
+
+class TestListCtrlPanel(wx.Panel, listmix.ColumnSorterMixin):
+    def __init__(self, parent, log):
+        wx.Panel.__init__(self, parent, -1, style=wx.WANTS_CHARS)
+
+        self.log = log
+        tID = wx.NewIdRef()
+
+        sizer = wx.BoxSizer(wx.VERTICAL)
+
+        if wx.Platform == "__WXMAC__" and \
+               hasattr(wx.GetApp().GetTopWindow(), "LoadDemo"):
+            self.useNative = wx.CheckBox(self, -1, "Use native listctrl")
+            self.useNative.SetValue(
+                not wx.SystemOptions.GetOptionInt("mac.listctrl.always_use_generic") )
+            self.Bind(wx.EVT_CHECKBOX, self.OnUseNative, self.useNative)
+            sizer.Add(self.useNative, 0, wx.ALL | wx.ALIGN_RIGHT, 4)
+
+        self.il = wx.ImageList(16, 16)
+
+        self.idx1 = self.il.Add(images.Smiles.GetBitmap())
+        self.sm_up = self.il.Add(images.SmallUpArrow.GetBitmap())
+        self.sm_dn = self.il.Add(images.SmallDnArrow.GetBitmap())
+
+        self.list = TestListCtrl(self, tID,
+                                 style=wx.LC_REPORT
+                                 #| wx.BORDER_SUNKEN
+                                 | wx.BORDER_NONE
+                                 | wx.LC_EDIT_LABELS
+                                 #| wx.LC_SORT_ASCENDING    # disabling initial auto sort gives a
+                                 #| wx.LC_NO_HEADER         # better illustration of col-click sorting
+                                 #| wx.LC_VRULES
+                                 #| wx.LC_HRULES
+                                 #| wx.LC_SINGLE_SEL
+                                 )
+
+        self.list.SetImageList(self.il, wx.IMAGE_LIST_SMALL)
+        sizer.Add(self.list, 1, wx.EXPAND)
+        self.list.EnableCheckBoxes(enable=True)
+
+        self.PopulateList()
+
+        # Now that the list exists we can init the other base class,
+        # see wx/lib/mixins/listctrl.py
+        self.itemDataMap = musicdata
+        listmix.ColumnSorterMixin.__init__(self, 3)
+        #self.SortListItems(0, True)
+
+        self.SetSizer(sizer)
+        self.SetAutoLayout(True)
+
+        self.Bind(wx.EVT_LIST_ITEM_SELECTED, self.OnItemSelected, self.list)
+        self.Bind(wx.EVT_LIST_ITEM_DESELECTED, self.OnItemDeselected, self.list)
+        self.Bind(wx.EVT_LIST_ITEM_ACTIVATED, self.OnItemActivated, self.list)
+        self.Bind(wx.EVT_LIST_DELETE_ITEM, self.OnItemDelete, self.list)
+        self.Bind(wx.EVT_LIST_COL_CLICK, self.OnColClick, self.list)
+        self.Bind(wx.EVT_LIST_COL_RIGHT_CLICK, self.OnColRightClick, self.list)
+        self.Bind(wx.EVT_LIST_COL_BEGIN_DRAG, self.OnColBeginDrag, self.list)
+        self.Bind(wx.EVT_LIST_COL_DRAGGING, self.OnColDragging, self.list)
+        self.Bind(wx.EVT_LIST_COL_END_DRAG, self.OnColEndDrag, self.list)
+        self.Bind(wx.EVT_LIST_BEGIN_LABEL_EDIT, self.OnBeginEdit, self.list)
+        self.Bind(wx.EVT_LIST_END_LABEL_EDIT, self.OnEndEdit, self.list)
+
+        self.list.Bind(wx.EVT_LEFT_DCLICK, self.OnDoubleClick)
+        self.list.Bind(wx.EVT_RIGHT_DOWN, self.OnRightDown)
+
+        # for wxMSW
+        self.list.Bind(wx.EVT_COMMAND_RIGHT_CLICK, self.OnRightClick)
+
+        # for wxGTK
+        self.list.Bind(wx.EVT_RIGHT_UP, self.OnRightClick)
+
+    def OnUseNative(self, event):
+        wx.SystemOptions.SetOption("mac.listctrl.always_use_generic", not event.IsChecked())
+        wx.GetApp().GetTopWindow().LoadDemo("ListCtrl")
+
+    def PopulateList(self):
+        if 0:
+            # for normal, simple columns, you can add them like this:
+            self.list.InsertColumn(0, "Artist")
+            self.list.InsertColumn(1, "Title", wx.LIST_FORMAT_RIGHT)
+            self.list.InsertColumn(2, "Genre")
+        else:
+            # but since we want images on the column header we have to do it the hard way:
+            info = wx.ListItem()
+            info.Mask = wx.LIST_MASK_TEXT | wx.LIST_MASK_IMAGE | wx.LIST_MASK_FORMAT
+            info.Image = -1
+            info.Align = 0
+            info.Text = "Artist"
+            self.list.InsertColumn(0, info)
+
+            info.Align = wx.LIST_FORMAT_RIGHT
+            info.Text = "Title"
+            self.list.InsertColumn(1, info)
+
+            info.Align = 0
+            info.Text = "Genre"
+            self.list.InsertColumn(2, info)
+
+        items = musicdata.items()
+        for key, data in items:
+            index = self.list.InsertItem(self.list.GetItemCount(), data[0], self.idx1)
+            self.list.SetItem(index, 1, data[1])
+            self.list.SetItem(index, 2, data[2])
+            self.list.SetItemData(index, key)
+
+        self.list.SetColumnWidth(0, wx.LIST_AUTOSIZE)
+        self.list.SetColumnWidth(1, wx.LIST_AUTOSIZE)
+        self.list.SetColumnWidth(2, 100)
+
+        # show how to select an item
+        self.list.SetItemState(5, wx.LIST_STATE_SELECTED, wx.LIST_STATE_SELECTED)
+
+        # show how to change the colour of a couple items
+        item = self.list.GetItem(1)
+        item.SetTextColour(wx.BLUE)
+        self.list.SetItem(item)
+        item = self.list.GetItem(4)
+        item.SetTextColour(wx.RED)
+        self.list.SetItem(item)
+
+        self.currentItem = 0
+
+    # Used by the ColumnSorterMixin, see wx/lib/mixins/listctrl.py
+    def GetListCtrl(self):
+        return self.list
+
+    # Used by the ColumnSorterMixin, see wx/lib/mixins/listctrl.py
+    def GetSortImages(self):
+        return (self.sm_dn, self.sm_up)
+
+    def OnRightDown(self, event):
+        x = event.GetX()
+        y = event.GetY()
+        self.log.WriteText("x, y = %s\n" % str((x, y)))
+        item, flags = self.list.HitTest((x, y))
+
+        if item != wx.NOT_FOUND and flags & wx.LIST_HITTEST_ONITEM:
+            self.list.Select(item)
+
+        event.Skip()
+
+    def getColumnText(self, index, col):
+        item = self.list.GetItem(index, col)
+        return item.GetText()
+
+    def OnItemSelected(self, event):
+        ##print(event.GetItem().GetTextColour())
+        self.currentItem = event.Index
+        self.log.WriteText("OnItemSelected: %s, %s, %s, %s\n" %
+                           (self.currentItem,
+                            self.list.GetItemText(self.currentItem),
+                            self.getColumnText(self.currentItem, 1),
+                            self.getColumnText(self.currentItem, 2)))
+
+        if self.currentItem == 10:
+            self.log.WriteText("OnItemSelected: Veto'd selection\n")
+            #event.Veto()  # doesn't work
+            # this does
+            self.list.SetItemState(10, 0, wx.LIST_STATE_SELECTED)
+
+        event.Skip()
+
+    def OnItemDeselected(self, event):
+        item = event.GetItem()
+        self.log.WriteText("OnItemDeselected: %d" % event.Index)
+
+        # Show how to reselect something we don't want deselected
+        if event.Index == 11:
+            wx.CallAfter(self.list.SetItemState, 11, wx.LIST_STATE_SELECTED, wx.LIST_STATE_SELECTED)
+
+    def OnItemActivated(self, event):
+        self.currentItem = event.Index
+        self.log.WriteText("OnItemActivated: %s\nTopItem: %s" %
+                           (self.list.GetItemText(self.currentItem), self.list.GetTopItem()))
+
+    def OnBeginEdit(self, event):
+        self.log.WriteText("OnBeginEdit")
+        event.Allow()
+
+    def OnEndEdit(self, event):
+        self.log.WriteText("OnEndEdit: " + event.GetText())
+        event.Allow()
+
+    def OnItemDelete(self, event):
+        self.log.WriteText("OnItemDelete\n")
+
+    def OnColClick(self, event):
+        self.log.WriteText("OnColClick: %d\n" % event.GetColumn())
+        event.Skip()
+
+    def OnColRightClick(self, event):
+        item = self.list.GetColumn(event.GetColumn())
+        self.log.WriteText("OnColRightClick: %d %s\n" %
+                           (event.GetColumn(), (item.GetText(), item.GetAlign(),
+                                                item.GetWidth(), item.GetImage())))
+        if self.list.HasColumnOrderSupport():
+            self.log.WriteText("OnColRightClick: column order: %d\n" %
+                               self.list.GetColumnOrder(event.GetColumn()))
+
+    def OnColBeginDrag(self, event):
+        self.log.WriteText("OnColBeginDrag\n")
+        ## Show how to not allow a column to be resized
+        #if event.GetColumn() == 0:
+        #    event.Veto()
+
+    def OnColDragging(self, event):
+        self.log.WriteText("OnColDragging\n")
+
+    def OnColEndDrag(self, event):
+        self.log.WriteText("OnColEndDrag\n")
+
+    def OnCheckAllBoxes(self, event):
+        itemcount = self.list.GetItemCount()
+        [self.list.CheckItem(item=i, check=True) for i in range(itemcount)]
+        self.log.WriteText("OnCheckAllBoxes\n")
+
+    def OnUnCheckAllBoxes(self, event):
+        itemcount = self.list.GetItemCount()
+        [self.list.CheckItem(item=i, check=False) for i in range(itemcount)]
+        self.log.WriteText("OnUnCheckAllBoxes\n")
+
+    def OnGetItemsChecked(self, event):
+        itemcount = self.list.GetItemCount()
+        itemschecked = [i for i in range(itemcount) if self.list.IsItemChecked(item=i)]
+        self.log.WriteText("OnGetItemsChecked: %s \n" % itemschecked)
+
+    def OnDoubleClick(self, event):
+        self.log.WriteText("OnDoubleClick item %s\n" % self.list.GetItemText(self.currentItem))
+        event.Skip()
+
+    def OnRightClick(self, event):
+        self.log.WriteText("OnRightClick %s\n" % self.list.GetItemText(self.currentItem))
+
+        # only do this part the first time so the events are only bound once
+        if not hasattr(self, "popupID1"):
+            self.popupID1 = wx.NewIdRef()
+            self.popupID2 = wx.NewIdRef()
+            self.popupID3 = wx.NewIdRef()
+            self.popupID4 = wx.NewIdRef()
+            self.popupID5 = wx.NewIdRef()
+            self.popupID6 = wx.NewIdRef()
+            self.popupID7 = wx.NewIdRef()
+            self.popupID8 = wx.NewIdRef()
+            self.popupID9 = wx.NewIdRef()
+
+            self.Bind(wx.EVT_MENU, self.OnPopupOne, id=self.popupID1)
+            self.Bind(wx.EVT_MENU, self.OnPopupTwo, id=self.popupID2)
+            self.Bind(wx.EVT_MENU, self.OnPopupThree, id=self.popupID3)
+            self.Bind(wx.EVT_MENU, self.OnPopupFour, id=self.popupID4)
+            self.Bind(wx.EVT_MENU, self.OnPopupFive, id=self.popupID5)
+            self.Bind(wx.EVT_MENU, self.OnPopupSix, id=self.popupID6)
+            self.Bind(wx.EVT_MENU, self.OnCheckAllBoxes, id=self.popupID7)
+            self.Bind(wx.EVT_MENU, self.OnUnCheckAllBoxes, id=self.popupID8)
+            self.Bind(wx.EVT_MENU, self.OnGetItemsChecked, id=self.popupID9)
+
+        # make a menu
+        menu = wx.Menu()
+        # add some items
+        menu.Append(self.popupID1, "FindItem tests")
+        menu.Append(self.popupID2, "Iterate Selected")
+        menu.Append(self.popupID3, "ClearAll and repopulate")
+        menu.Append(self.popupID4, "DeleteAllItems")
+        menu.Append(self.popupID5, "GetItem")
+        menu.Append(self.popupID6, "Edit")
+        menu.Append(self.popupID7, "Check All Boxes")
+        menu.Append(self.popupID8, "UnCheck All Boxes")
+        menu.Append(self.popupID9, "Get Checked Items")
+
+        # Popup the menu.  If an item is selected then its handler
+        # will be called before PopupMenu returns.
+        self.PopupMenu(menu)
+        menu.Destroy()
+
+    def OnPopupOne(self, event):
+        self.log.WriteText("Popup one\n")
+        print("FindItem:", self.list.FindItem(-1, "Roxette"))
+        print("FindItemData:", self.list.FindItemData(-1, 11))
+
+    def OnPopupTwo(self, event):
+        self.log.WriteText("Selected items:\n")
+        index = self.list.GetFirstSelected()
+
+        while index != -1:
+            self.log.WriteText("      %s: %s\n" % (self.list.GetItemText(index),
+                                                   self.getColumnText(index, 1)))
+            index = self.list.GetNextSelected(index)
+
+    def OnPopupThree(self, event):
+        self.log.WriteText("Popup three\n")
+        self.list.ClearAll()
+        wx.CallAfter(self.PopulateList)
+
+    def OnPopupFour(self, event):
+        self.list.DeleteAllItems()
+
+    def OnPopupFive(self, event):
+        item = self.list.GetItem(self.currentItem)
+        self.log.WriteText("Text:%s, Id:%s, Data:%s" %(item.Text,
+                                                       item.Id,
+                                                       self.list.GetItemData(self.currentItem)))
+
+    def OnPopupSix(self, event):
+        self.list.EditLabel(self.currentItem)
+
+
+#---------------------------------------------------------------------------
+
+def runTest(frame, nb, log):
+    win = TestListCtrlPanel(nb, log)
+    return win
+
+#---------------------------------------------------------------------------
+
+
+overview = """\
+<html>
+<body>
+A list control presents lists in a number of formats: list view, report view,
+icon view and small icon view. In any case, elements are numbered from zero.
+For all these modes (but not for virtual list controls), the items are stored
+in the control and must be added to it using InsertItem method.
+
+<p>To intercept events from a list control, use the event table macros described in
+<code>wxListEvent.</code>
+
+<h3>Mix-ins</h3>
+This example demonstrates how to use mixins. The following mixins are available.
+
+<h4>ColumnSorterMixin</h4>
+
+<code><b>ColumnSorterMixin(numColumns)</b></code>
+
+<p>A mixin class that handles sorting of a wxListCtrl in REPORT mode when the column
+header is clicked on.
+
+<p>There are a few requirements needed in order for this to work genericly:
+<p><ol>
+    <li>The combined class must have a <code>GetListCtrl</code> method that returns
+    the ListCtrl to be sorted, and the list control must exist at the time the
+    <code>ColumnSorterMixin.__init__()</code>method is called because it uses
+    <code>GetListCtrl</code>.
+
+    <li>Items in the list control must have a unique data value set with
+    <code>list.SetItemData</code>.
+
+    <li>The combined class must have an attribute named <code>itemDataMap</code>
+    that is a dictionary mapping the data values to a sequence of objects
+    representing the values in each column.  These valuesare compared in
+    the column sorter to determine sort order.
+</ol>
+
+<p>Interesting methods to override are <code>GetColumnSorter</code>,
+<code>GetSecondarySortValues</code>, and <code>GetSortImages</code>.
+
+<h5>Methods</h5>
+<dl>
+<dt><code>SetColumnCount(newNumColumns)</code>
+<dd>Informs the mixin as to the number of columns in the control. When it is
+set, it also sets up an event handler for <code>EVT_LIST_COL_CLICK</code> events.
+
+<dt><code>SortListItems(col=-1, ascending=1)</code>
+<dd>Sort the list on demand.  Can also be used to set the sort column and order.
+
+<dt><code>GetColumnWidths()</code>
+<dd>Returns a list of column widths.  Can be used to help restore the current
+view later.
+
+<dt><code>GetSortImages()</code>
+<dd>Returns a tuple of image list indexes the indexes in the image list for an
+image to be put on the column header when sorting in descending order
+
+<dt><code>GetColumnSorter()</code>
+<dd>Returns a callable object to be used for comparing column values when sorting.
+
+<dt><code>GetSecondarySortValues(col, key1, key2)</code>
+<dd>Returns a tuple of 2 values to use for secondary sort values when the
+items in the selected column match equal.  The default just returns the
+item data values.
+
+</dl>
+
+<h4>ListCtrlAutoWidthMixin</h4>
+
+<code><b>ListCtrlAutoWidthMixin()</b></code>
+
+<p>A mix-in class that automatically resizes the last column to take up the
+remaining width of the ListCtrl.
+
+<p>This causes the ListCtrl to automatically take up the full width of the list,
+without either a horizontal scroll bar (unless absolutely necessary) or empty
+space to the right of the last column.
+
+<p><b>NOTE:</b> This only works for report-style lists.
+
+<p><b>WARNING:</b> If you override the <code>EVT_SIZE</code> event in your ListCtrl,
+make sure you call event.Skip() to ensure that the mixin's _OnResize method is
+called.
+
+<p>This mix-in class was written by <a href='mailto:ewestra@wave.co.nz'>Erik Westra </a>
+
+<h5>Methods</h5>
+<dl>
+
+<dt><code>resizeLastColumn(minWidth)</code>
+<dd>Resize the last column appropriately. If the list's columns are too wide to
+fit within the window, we use a horizontal scrollbar.  Otherwise, we expand the
+right-most column to take up the remaining free space in the list. This method is
+called automatically when the ListCtrl is resized; you can also call it yourself
+whenever you want the last column to be resized appropriately (eg, when adding,
+removing or resizing columns).  'minWidth' is the preferred minimum width for
+the last column.
+
+</dl>
+
+
+<h4>ListCtrlSelectionManagerMix</h4>
+
+<code><b>ListCtrlSelectionManagerMix()</b></code>
+
+<p>Mixin that defines a platform independent selection policy
+
+<p>As selection single and multi-select list return the item index or a
+list of item indexes respectively.
+
+<h5>Methods</h5>
+<dl>
+
+<dt><code>getPopupMenu()</code>
+<dd>Override to implement dynamic menus (create)
+
+<dt><code>setPopupMenu(menu)</code>
+<dd>Must be set for default behaviour.
+
+<dt><code>afterPopupMenu()</code>
+<dd>Override to implement dynamic menus (destroy).
+
+<dt><code>getSelection()</code>
+<dd>Returns the current selection (or selections  as a Python list if extended
+selection is enabled)
+
+
+</body>
+</html>
+"""
+
+
+if __name__ == '__main__':
+    import sys,os
+    import run
+    run.main(['', os.path.basename(sys.argv[0])] + sys.argv[1:])
+

wx/demo/ListCtrl_edit.py

@@ -0,0 +1,155 @@
+#!/usr/bin/env python
+
+#----------------------------------------------------------------------------
+# Name:         ListCtrl_edit.py
+# Purpose:      Testing editing a ListCtrl
+#
+# Author:       Pim van Heuven
+#
+# Created:      2004/10/15
+# Copyright:    (c) Pim Van Heuven
+# Licence:      wxWindows license
+#----------------------------------------------------------------------------
+
+import sys
+import wx
+import wx.lib.mixins.listctrl as listmix
+
+#---------------------------------------------------------------------------
+
+listctrldata = {
+1 : ("Hey!", "You can edit", "me!"),
+2 : ("Try changing the contents", "by", "clicking"),
+3 : ("in", "a", "cell"),
+4 : ("See how the length columns", "change", "?"),
+5 : ("You can use", "TAB,", "cursor down,"),
+6 : ("and cursor up", "to", "navigate"),
+}
+
+#---------------------------------------------------------------------------
+
+class TestListCtrl(wx.ListCtrl,
+                   listmix.ListCtrlAutoWidthMixin,
+                   listmix.TextEditMixin):
+
+    def __init__(self, parent, ID, pos=wx.DefaultPosition,
+                 size=wx.DefaultSize, style=0):
+        wx.ListCtrl.__init__(self, parent, ID, pos, size, style)
+
+        listmix.ListCtrlAutoWidthMixin.__init__(self)
+        self.Populate()
+        listmix.TextEditMixin.__init__(self)
+
+
+    def Populate(self):
+        # for normal, simple columns, you can add them like this:
+        self.InsertColumn(0, "Column 1")
+        self.InsertColumn(1, "Column 2")
+        self.InsertColumn(2, "Column 3")
+        self.InsertColumn(3, "Len 1", wx.LIST_FORMAT_RIGHT)
+        self.InsertColumn(4, "Len 2", wx.LIST_FORMAT_RIGHT)
+        self.InsertColumn(5, "Len 3", wx.LIST_FORMAT_RIGHT)
+
+        items = listctrldata.items()
+        for key, data in items:
+            index = self.InsertItem(self.GetItemCount(), data[0])
+            self.SetItem(index, 1, data[1])
+            self.SetItem(index, 2, data[2])
+            self.SetItemData(index, key)
+
+        self.SetColumnWidth(0, wx.LIST_AUTOSIZE)
+        self.SetColumnWidth(1, wx.LIST_AUTOSIZE)
+        self.SetColumnWidth(2, 100)
+
+        self.currentItem = 0
+
+
+    def SetStringItem(self, index, col, data):
+        if col in range(3):
+            wx.ListCtrl.SetItem(self, index, col, data)
+            wx.ListCtrl.SetItem(self, index, 3+col, str(len(data)))
+        else:
+            try:
+                datalen = int(data)
+            except:
+                return
+
+            wx.ListCtrl.SetItem(self, index, col, data)
+
+            data = self.GetItem(index, col-3).GetText()
+            wx.ListCtrl.SetItem(self, index, col-3, data[0:datalen])
+
+
+
+class TestListCtrlPanel(wx.Panel):
+    def __init__(self, parent, log):
+        wx.Panel.__init__(self, parent, -1, style=wx.WANTS_CHARS)
+
+        self.log = log
+        tID = wx.NewIdRef()
+
+        sizer = wx.BoxSizer(wx.VERTICAL)
+
+        if wx.Platform == "__WXMAC__" and \
+               hasattr(wx.GetApp().GetTopWindow(), "LoadDemo"):
+            self.useNative = wx.CheckBox(self, -1, "Use native listctrl")
+            self.useNative.SetValue(
+                not wx.SystemOptions.GetOptionInt("mac.listctrl.always_use_generic") )
+            self.Bind(wx.EVT_CHECKBOX, self.OnUseNative, self.useNative)
+            sizer.Add(self.useNative, 0, wx.ALL | wx.ALIGN_RIGHT, 4)
+
+        self.list = TestListCtrl(self, tID,
+                                 style=wx.LC_REPORT
+                                 | wx.BORDER_NONE
+                                 #| wx.LC_SORT_ASCENDING            # Content of list as instructions is
+                                 | wx.LC_HRULES | wx.LC_VRULES      # nonsense with auto-sort enabled
+                                 )
+
+        sizer.Add(self.list, 1, wx.EXPAND)
+        self.SetSizer(sizer)
+        self.SetAutoLayout(True)
+
+
+    def OnUseNative(self, event):
+        wx.SystemOptions.SetOption("mac.listctrl.always_use_generic", not event.IsChecked())
+        wx.GetApp().GetTopWindow().LoadDemo("ListCtrl_edit")
+
+
+
+#---------------------------------------------------------------------------
+
+def runTest(frame, nb, log):
+    win = TestListCtrlPanel(nb, log)
+    return win
+
+#---------------------------------------------------------------------------
+
+
+overview = """\
+<html>
+<body>
+
+This demo demonstrates direct editing of all cells of a ListCtrl. To
+enable it just include the <b>TextEditMixin</b>. The ListCtrl can be
+navigated with the TAB and up/down cursor keys.
+
+<p>Another facet of this demo is that the remaining space of the
+ListCtrls is divided over the first three columns. This is achieved
+with the extended syntax of <b>ListCtrlAutoWidthMixin</b>:
+<code>listmix.ListCtrlAutoWidthMixin.__init__(self, startcol, endcol)</code>
+(Look at the general ListCtrl demo for more information about the
+ListCtrlAutoWidthMixin)
+
+<p>Finally, the ListCtrl is automatically scrolled, if needed, when
+TAB is pressed consecutively (Windows only).
+
+</body>
+</html>
+"""
+
+
+if __name__ == '__main__':
+    import sys,os
+    import run
+    run.main(['', os.path.basename(sys.argv[0])] + sys.argv[1:])
+