Phoenix Logo

phoenix_title wx.ListView

This class currently simply presents a simpler to use interface for the wx.ListCtrl façade for that complicated class.

Using it is preferable to using wx.ListCtrl directly whenever possible because in the future some ports might implement wx.ListView but not the full set of wx.ListCtrl features.

Other than different interface, this class is identical to wx.ListCtrl. In particular, it uses the same events, same window styles and so on.


class_hierarchy Class Hierarchy

Inheritance diagram for class ListView:

appearance Control Appearance


wxMSW

wxMSW

wxMAC

wxMAC

wxGTK

wxGTK


method_summary Methods Summary

__init__ Default constructor.
ClearColumnImage Resets the column image
Focus Sets focus to the item with the given index.
GetFirstSelected Returns the first selected item in a (presumably) multiple selection control.
GetFocusedItem Returns the currently focused item or -1 if none.
GetNextSelected Used together with GetFirstSelected to iterate over all selected items in the control.
IsSelected Returns True if the item with the given index is selected, False otherwise.
Select Selects or unselects the given item.
SetColumnImage Sets the column image for the specified column.

api Class API



class wx.ListView(ListCtrl)

Possible constructors:

ListView()

ListView(parent, winid=ID_ANY, pos=DefaultPosition, size=DefaultSize,
         style=LC_REPORT, validator=DefaultValidator, name=ListCtrlNameStr)

This class currently simply presents a simpler to use interface for the ListCtrl it can be thought of as a façade for that complicated class.


Methods



__init__(self, *args, **kw)

overload Overloaded Implementations:



__init__ (self)

Default constructor.



__init__ (self, parent, winid=ID_ANY, pos=DefaultPosition, size=DefaultSize, style=LC_REPORT, validator=DefaultValidator, name=ListCtrlNameStr)

Constructor, creating and showing a listview control.

Parameters:
  • parent (wx.Window) – Parent window. Must not be None.
  • winid (wx.WindowID) –
  • pos (wx.Point) – Window position. If wx.DefaultPosition is specified then a default position is chosen.
  • size (wx.Size) – Window size. If wx.DefaultSize is specified then the window is sized appropriately.
  • style (long) – Window style. See wx.ListCtrl.
  • validator (wx.Validator) – Window validator.
  • name (string) – Window name.

Window identifier. The value wx.ID_ANY indicates a default value.

See also

Create , wx.Validator





ClearColumnImage(self, col)

Resets the column image

Parameters:col (int) – the column to clear image for

See also

SetColumnImage



Focus(self, index)

Sets focus to the item with the given index.

Parameters:index (long) –


GetFirstSelected(self)

Returns the first selected item in a (presumably) multiple selection control.

Together with GetNextSelected it can be used to iterate over all selected items in the control.

Return type:long
Returns:The first selected item, if any, -1 otherwise.


GetFocusedItem(self)

Returns the currently focused item or -1 if none.

Return type:long

See also

IsSelected , Focus



GetNextSelected(self, item)

Used together with GetFirstSelected to iterate over all selected items in the control.

Parameters:item (long) –
Return type:long
Returns:Returns the next selected item or -1 if there are no more of them.


IsSelected(self, index)

Returns True if the item with the given index is selected, False otherwise.

Parameters:index (long) –
Return type:bool


Select(self, n, on=True)

Selects or unselects the given item.

Parameters:
  • n (long) – the item to select or unselect
  • on (bool) – if True (default), selects the item, otherwise unselects it


SetColumnImage(self, col, image)

Sets the column image for the specified column.

To use the column images, the control must have a valid image list with at least one image.

Parameters:
  • col (int) – the column to set image for
  • image (int) – the index of the column image in the controls image list

Properties



FirstSelected

See GetFirstSelected



FocusedItem

See GetFocusedItem