095315e20d
git-svn-id: https://svn.wxwidgets.org/svn/wx/wxWidgets/trunk@36730 c3d73ce0-8a6f-49c7-b76d-6d57e0e08775
501 lines
18 KiB
Python
501 lines
18 KiB
Python
#----------------------------------------------------------------------------
|
|
# Name: ListCtrl.py
|
|
# Purpose: Testing lots of stuff, controls, window types, etc.
|
|
#
|
|
# Author: Robin Dunn & Gary Dumer
|
|
#
|
|
# Created:
|
|
# RCS-ID: $Id$
|
|
# Copyright: (c) 1998 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: ("Billy Joel", "Lullabye (Goodnight, My Angel)", "Rock"),
|
|
21: ("Billy Joel", "The River Of Dreams", "Rock"),
|
|
22: ("Billy Joel", "Two Thousand Years", "Rock"),
|
|
23: ("Janet Jackson", "Alright", "Rock"),
|
|
24: ("Janet Jackson", "Black Cat", "Rock"),
|
|
25: ("Janet Jackson", "Come Back To Me", "Rock"),
|
|
26: ("Janet Jackson", "Escapade", "Rock"),
|
|
27: ("Janet Jackson", "Love Will Never Do (Without You)", "Rock"),
|
|
28: ("Janet Jackson", "Miss You Much", "Rock"),
|
|
29: ("Janet Jackson", "Rhythm Nation", "Rock"),
|
|
30: ("Janet Jackson", "State Of The World", "Rock"),
|
|
31: ("Janet Jackson", "The Knowledge", "Rock"),
|
|
32: ("Spyro Gyra", "End of Romanticism", "Jazz"),
|
|
33: ("Spyro Gyra", "Heliopolis", "Jazz"),
|
|
34: ("Spyro Gyra", "Jubilee", "Jazz"),
|
|
35: ("Spyro Gyra", "Little Linda", "Jazz"),
|
|
36: ("Spyro Gyra", "Morning Dance", "Jazz"),
|
|
37: ("Spyro Gyra", "Song for Lorraine", "Jazz"),
|
|
38: ("Yes", "Owner Of A Lonely Heart", "Rock"),
|
|
39: ("Yes", "Rhythm Of Love", "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.NewId()
|
|
|
|
self.il = wx.ImageList(16, 16)
|
|
|
|
self.idx1 = self.il.Add(images.getSmilesBitmap())
|
|
self.sm_up = self.il.Add(images.getSmallUpArrowBitmap())
|
|
self.sm_dn = self.il.Add(images.getSmallDnArrowBitmap())
|
|
|
|
self.list = TestListCtrl(self, tID,
|
|
style=wx.LC_REPORT
|
|
#| wx.BORDER_SUNKEN
|
|
| wx.BORDER_NONE
|
|
| wx.LC_EDIT_LABELS
|
|
| wx.LC_SORT_ASCENDING
|
|
#| wx.LC_NO_HEADER
|
|
#| wx.LC_VRULES
|
|
#| wx.LC_HRULES
|
|
#| wx.LC_SINGLE_SEL
|
|
)
|
|
|
|
self.list.SetImageList(self.il, wx.IMAGE_LIST_SMALL)
|
|
|
|
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.Bind(wx.EVT_SIZE, self.OnSize)
|
|
|
|
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.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 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.m_mask = wx.LIST_MASK_TEXT | wx.LIST_MASK_IMAGE | wx.LIST_MASK_FORMAT
|
|
info.m_image = -1
|
|
info.m_format = 0
|
|
info.m_text = "Artist"
|
|
self.list.InsertColumnInfo(0, info)
|
|
|
|
info.m_format = wx.LIST_FORMAT_RIGHT
|
|
info.m_text = "Title"
|
|
self.list.InsertColumnInfo(1, info)
|
|
|
|
info.m_format = 0
|
|
info.m_text = "Genre"
|
|
self.list.InsertColumnInfo(2, info)
|
|
|
|
items = musicdata.items()
|
|
for key, data in items:
|
|
index = self.list.InsertImageStringItem(sys.maxint, data[0], self.idx1)
|
|
self.list.SetStringItem(index, 1, data[1])
|
|
self.list.SetStringItem(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 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.m_itemIndex
|
|
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, evt):
|
|
item = evt.GetItem()
|
|
self.log.WriteText("OnItemDeselected: %d" % evt.m_itemIndex)
|
|
|
|
# Show how to reselect something we don't want deselected
|
|
if evt.m_itemIndex == 11:
|
|
wx.CallAfter(self.list.SetItemState, 11, wx.LIST_STATE_SELECTED, wx.LIST_STATE_SELECTED)
|
|
|
|
|
|
def OnItemActivated(self, event):
|
|
self.currentItem = event.m_itemIndex
|
|
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 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())))
|
|
|
|
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 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.NewId()
|
|
self.popupID2 = wx.NewId()
|
|
self.popupID3 = wx.NewId()
|
|
self.popupID4 = wx.NewId()
|
|
self.popupID5 = wx.NewId()
|
|
self.popupID6 = wx.NewId()
|
|
|
|
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)
|
|
|
|
# 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")
|
|
|
|
# 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)
|
|
print item.m_text, item.m_itemId, self.list.GetItemData(self.currentItem)
|
|
|
|
def OnPopupSix(self, event):
|
|
self.list.EditLabel(self.currentItem)
|
|
|
|
|
|
def OnSize(self, event):
|
|
w,h = self.GetClientSizeTuple()
|
|
self.list.SetDimensions(0, 0, w, h)
|
|
|
|
|
|
|
|
#---------------------------------------------------------------------------
|
|
|
|
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 requirments 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:])
|
|
|