More changes to make the autodocs be better, made all the namestrings

[wxWidgets.git] / wxPython / demo / wxListCtrl.py

diff --git a/wxPython/demo/wxListCtrl.py b/wxPython/demo/wxListCtrl.py
index d640ecddb65f9a0ee1bb58bb417af718113e2977..75412e7dd761c500c2f86b82ea4e719e8d36c6ba 100644 (file)
--- a/wxPython/demo/wxListCtrl.py
+++ b/wxPython/demo/wxListCtrl.py
@@ -9,9 +9,26 @@
 # Copyright:    (c) 1998 by Total Control Software
 # Licence:      wxWindows license
 #----------------------------------------------------------------------------
 # Copyright:    (c) 1998 by Total Control Software
 # Licence:      wxWindows license
 #----------------------------------------------------------------------------

+#
+# 11/20/2003 - Jeff Grimmett (grimmtooth@softhome.net)
+#
+# o Updated for wx namespace
+# 
+# 11/29/2003 - Jeff Grimmett (grimmtooth@softhome.net)
+#
+# o listctrl mixin needs wx renamer.
+# o wx.ListItem.GetText() returns a wxString pointer, not the text.
+# 
+# 12/14/2003 - Jeff Grimmett (grimmtooth@softhome.net)
+#
+# o ColumnSorterMixin implementation was broke - added event.Skip()
+#   to column click event to allow event to fall through to mixin.
+#
+
+import  wx
+import  wx.lib.mixins.listctrl  as  listmix

 
 

-from wxPython.wx import *
-from wxPython.lib.mixins.listctrl import wxColumnSorterMixin, wxListCtrlAutoWidthMixin
+import  images

 
 #---------------------------------------------------------------------------
 
 
 #---------------------------------------------------------------------------
 


@@ -72,82 +89,85 @@ musicdata = {
 54: ("David Lanz", "Leaves on the Seine", "New Age"),
 }
 
 54: ("David Lanz", "Leaves on the Seine", "New Age"),
 }
 

-import images
-
-
-class TestListCtrl(wxListCtrl, wxListCtrlAutoWidthMixin):
-    def __init__(self, parent, ID, pos=wxDefaultPosition,
-                 size=wxDefaultSize, style=0):
-        wxListCtrl.__init__(self, parent, ID, pos, size, style)
-        wxListCtrlAutoWidthMixin.__init__(self)
+#---------------------------------------------------------------------------

 
 

+class TestListCtrl(wx.ListCtrl, listmix.wxListCtrlAutoWidthMixin):
+    def __init__(self, parent, ID, pos=wx.DefaultPosition,
+                 size=wx.DefaultSize, style=0):
+        wx.ListCtrl.__init__(self, parent, ID, pos, size, style)
+        listmix.wxListCtrlAutoWidthMixin.__init__(self)

 
 
 
 

-class TestListCtrlPanel(wxPanel, wxColumnSorterMixin):
+class TestListCtrlPanel(wx.Panel, listmix.wxColumnSorterMixin):

     def __init__(self, parent, log):
     def __init__(self, parent, log):

-        wxPanel.__init__(self, parent, -1, style=wxWANTS_CHARS)
+        wx.Panel.__init__(self, parent, -1, style=wx.WANTS_CHARS)

 
         self.log = log
 
         self.log = log

-        tID = wxNewId()
+        tID = wx.NewId()

 
 

-        self.il = wxImageList(16, 16)
+        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,
 
         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=wxLC_REPORT | wxSUNKEN_BORDER
+                                 style=wx.LC_REPORT 
+                                 | wx.SUNKEN_BORDER
+                                 | wx.LC_EDIT_LABELS

                                  #| wxLC_NO_HEADER
                                  #| wxLC_VRULES | wxLC_HRULES
                                  )
                                  #| wxLC_NO_HEADER
                                  #| wxLC_VRULES | wxLC_HRULES
                                  )

-        self.list.SetImageList(self.il, wxIMAGE_LIST_SMALL)
+
+        self.list.SetImageList(self.il, wx.IMAGE_LIST_SMALL)

 
         self.PopulateList()
 
         # Now that the list exists we can init the other base class,
         # see wxPython/lib/mixins/listctrl.py
         self.itemDataMap = musicdata
 
         self.PopulateList()
 
         # Now that the list exists we can init the other base class,
         # see wxPython/lib/mixins/listctrl.py
         self.itemDataMap = musicdata

-        wxColumnSorterMixin.__init__(self, 3)
+        listmix.wxColumnSorterMixin.__init__(self, 3)

         #self.SortListItems(0, True)
 
         #self.SortListItems(0, True)
 

-        EVT_SIZE(self, self.OnSize)
-        EVT_LIST_ITEM_SELECTED(self, tID, self.OnItemSelected)
-        EVT_LIST_ITEM_DESELECTED(self, tID, self.OnItemDeselected)
-        EVT_LIST_ITEM_ACTIVATED(self, tID, self.OnItemActivated)
-        EVT_LIST_DELETE_ITEM(self, tID, self.OnItemDelete)
-        EVT_LIST_COL_CLICK(self, tID, self.OnColClick)
-        EVT_LIST_COL_RIGHT_CLICK(self, tID, self.OnColRightClick)
-        EVT_LIST_COL_BEGIN_DRAG(self, tID, self.OnColBeginDrag)
-        EVT_LIST_COL_DRAGGING(self, tID, self.OnColDragging)
-        EVT_LIST_COL_END_DRAG(self, tID, self.OnColEndDrag)
+        self.Bind(wx.EVT_SIZE, self.OnSize)

 
 

-        EVT_LEFT_DCLICK(self.list, self.OnDoubleClick)
-        EVT_RIGHT_DOWN(self.list, self.OnRightDown)
+        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
 
         # for wxMSW

-        EVT_COMMAND_RIGHT_CLICK(self.list, tID, self.OnRightClick)
+        self.list.Bind(wx.EVT_COMMAND_RIGHT_CLICK, self.OnRightClick)

 
         # for wxGTK
 
         # for wxGTK

-        EVT_RIGHT_UP(self.list, self.OnRightClick)
+        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")
 
 
     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", wxLIST_FORMAT_RIGHT)
+            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:
             self.list.InsertColumn(2, "Genre")
         else:
             # but since we want images on the column header we have to do it the hard way:

-            info = wxListItem()
-            info.m_mask = wxLIST_MASK_TEXT | wxLIST_MASK_IMAGE | wxLIST_MASK_FORMAT
+            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_image = -1
             info.m_format = 0
             info.m_text = "Artist"
             self.list.InsertColumnInfo(0, info)
 

-            info.m_format = wxLIST_FORMAT_RIGHT
+            info.m_format = wx.LIST_FORMAT_RIGHT

             info.m_text = "Title"
             self.list.InsertColumnInfo(1, info)
 
             info.m_text = "Title"
             self.list.InsertColumnInfo(1, info)
 


@@ -163,19 +183,19 @@ class TestListCtrlPanel(wxPanel, wxColumnSorterMixin):
             self.list.SetStringItem(x, 2, data[2])
             self.list.SetItemData(x, key)
 
             self.list.SetStringItem(x, 2, data[2])
             self.list.SetItemData(x, key)
 

-        self.list.SetColumnWidth(0, wxLIST_AUTOSIZE)
-        self.list.SetColumnWidth(1, wxLIST_AUTOSIZE)
+        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.SetColumnWidth(2, 100)
 
         # show how to select an item

-        self.list.SetItemState(5, wxLIST_STATE_SELECTED, wxLIST_STATE_SELECTED)
+        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)
 
         # show how to change the colour of a couple items
         item = self.list.GetItem(1)

-        item.SetTextColour(wxBLUE)
+        item.SetTextColour(wx.BLUE)

         self.list.SetItem(item)
         item = self.list.GetItem(4)
         self.list.SetItem(item)
         item = self.list.GetItem(4)

-        item.SetTextColour(wxRED)
+        item.SetTextColour(wx.RED)

         self.list.SetItem(item)
 
         self.currentItem = 0
         self.list.SetItem(item)
 
         self.currentItem = 0


@@ -195,8 +215,10 @@ class TestListCtrlPanel(wxPanel, wxColumnSorterMixin):
         self.y = event.GetY()
         self.log.WriteText("x, y = %s\n" % str((self.x, self.y)))
         item, flags = self.list.HitTest((self.x, self.y))
         self.y = event.GetY()
         self.log.WriteText("x, y = %s\n" % str((self.x, self.y)))
         item, flags = self.list.HitTest((self.x, self.y))

-        if flags & wxLIST_HITTEST_ONITEM:
+
+        if flags & wx.LIST_HITTEST_ONITEM:

             self.list.Select(item)
             self.list.Select(item)

+

         event.Skip()
 
 
         event.Skip()
 
 


@@ -213,11 +235,15 @@ class TestListCtrlPanel(wxPanel, wxColumnSorterMixin):
                             self.list.GetItemText(self.currentItem),
                             self.getColumnText(self.currentItem, 1),
                             self.getColumnText(self.currentItem, 2)))
                             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
         if self.currentItem == 10:
             self.log.WriteText("OnItemSelected: Veto'd selection\n")
             #event.Veto()  # doesn't work
             # this does

-            self.list.SetItemState(10, 0, wxLIST_STATE_SELECTED)
+            self.list.SetItemState(10, 0, wx.LIST_STATE_SELECTED)
+
+        event.Skip()
+

 
     def OnItemDeselected(self, evt):
         item = evt.GetItem()
 
     def OnItemDeselected(self, evt):
         item = evt.GetItem()


@@ -225,7 +251,7 @@ class TestListCtrlPanel(wxPanel, wxColumnSorterMixin):
 
         # Show how to reselect something we don't want deselected
         if evt.m_itemIndex == 11:
 
         # Show how to reselect something we don't want deselected
         if evt.m_itemIndex == 11:

-            wxCallAfter(self.list.SetItemState, 11, wxLIST_STATE_SELECTED, wxLIST_STATE_SELECTED)
+            wx.CallAfter(self.list.SetItemState, 11, wx.LIST_STATE_SELECTED, wx.LIST_STATE_SELECTED)

 
 
     def OnItemActivated(self, event):
 
 
     def OnItemActivated(self, event):


@@ -233,11 +259,16 @@ class TestListCtrlPanel(wxPanel, wxColumnSorterMixin):
         self.log.WriteText("OnItemActivated: %s\nTopItem: %s" %
                            (self.list.GetItemText(self.currentItem), self.list.GetTopItem()))
 
         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())
     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())
 
     def OnColRightClick(self, event):
         item = self.list.GetColumn(event.GetColumn())


@@ -265,34 +296,35 @@ class TestListCtrlPanel(wxPanel, wxColumnSorterMixin):
     def OnRightClick(self, event):
         self.log.WriteText("OnRightClick %s\n" % self.list.GetItemText(self.currentItem))
 
     def OnRightClick(self, event):
         self.log.WriteText("OnRightClick %s\n" % self.list.GetItemText(self.currentItem))
 

-        # only do this part the first time
+        # only do this part the first time so the events are only bound once

         if not hasattr(self, "popupID1"):
         if not hasattr(self, "popupID1"):

-            self.popupID1 = wxNewId()
-            self.popupID2 = wxNewId()
-            self.popupID3 = wxNewId()
-            self.popupID4 = wxNewId()
-            self.popupID5 = wxNewId()
-            EVT_MENU(self, self.popupID1, self.OnPopupOne)
-            EVT_MENU(self, self.popupID2, self.OnPopupTwo)
-            EVT_MENU(self, self.popupID3, self.OnPopupThree)
-            EVT_MENU(self, self.popupID4, self.OnPopupFour)
-            EVT_MENU(self, self.popupID5, self.OnPopupFive)
+            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
 
         # make a menu

-        menu = wxMenu()
-        # Show how to put an icon in the menu
-        item = wxMenuItem(menu, self.popupID1,"One")
-        item.SetBitmap(images.getSmilesBitmap())
-        menu.AppendItem(item)
-        # add some other items
-        menu.Append(self.popupID2, "Two")
+        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.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.
 
         # Popup the menu.  If an item is selected then its handler
         # will be called before PopupMenu returns.

-        self.PopupMenu(menu, wxPoint(self.x, self.y))
+        self.PopupMenu(menu, (self.x, self.y))

         menu.Destroy()
 
 
         menu.Destroy()
 
 


@@ -302,14 +334,17 @@ class TestListCtrlPanel(wxPanel, wxColumnSorterMixin):
         print "FindItemData:", self.list.FindItemData(-1, 11)
 
     def OnPopupTwo(self, event):
         print "FindItemData:", self.list.FindItemData(-1, 11)
 
     def OnPopupTwo(self, event):

-        self.log.WriteText("Popup two\n")
+        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()
 
     def OnPopupThree(self, event):
         self.log.WriteText("Popup three\n")
         self.list.ClearAll()

-        wxCallAfter(self.PopulateList)
-        #wxYield()
-        #self.PopulateList()
+        wx.CallAfter(self.PopulateList)

 
     def OnPopupFour(self, event):
         self.list.DeleteAllItems()
 
     def OnPopupFour(self, event):
         self.list.DeleteAllItems()


@@ -318,15 +353,16 @@ class TestListCtrlPanel(wxPanel, wxColumnSorterMixin):
         item = self.list.GetItem(self.currentItem)
         print item.m_text, item.m_itemId, self.list.GetItemData(self.currentItem)
 
         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 OnSize(self, event):
         w,h = self.GetClientSizeTuple()
         self.list.SetDimensions(0, 0, w, h)
 
 
 

-
-
-

 #---------------------------------------------------------------------------
 
 def runTest(frame, nb, log):
 #---------------------------------------------------------------------------
 
 def runTest(frame, nb, log):


@@ -336,15 +372,136 @@ def runTest(frame, nb, log):
 #---------------------------------------------------------------------------
 
 
 #---------------------------------------------------------------------------
 
 

+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>

 
 

-overview = """\
-A list control presents lists in a number of formats: list view, report view, icon view and small icon view. Elements are numbered from zero.
+<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>wxListCtrlAutoWidthMixin()</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__':
 
 
 if __name__ == '__main__':