wx.ListItem¶

This class stores information about a wx.ListCtrl item or column.

wx.ListItem is a class which contains information about:

Zero based item position; see SetId and GetId.
Zero based column index; see SetColumn and GetColumn.
The label (or header for columns); see SetText and GetText.
The zero based index into an image list; see GetImage and SetImage.
Application defined data; see SetData and GetData.
For columns only: the width of the column; see SetWidth and GetWidth.
For columns only: the format of the column; one of LIST_FORMAT_LEFT , LIST_FORMAT_RIGHT , LIST_FORMAT_CENTRE . See SetAlign and GetAlign.
The state of the item; see SetState and GetState. This is a bitlist of the following flags:
- LIST_STATE_FOCUSED: The item has the focus.
- LIST_STATE_SELECTED: The item is selected.
- LIST_STATE_DONTCARE: Don’t care what the state is. Win32 only.
- LIST_STATE_DROPHILITED: The item is highlighted to receive a drop event. Win32 only.
- LIST_STATE_CUT: The item is in the cut state. Win32 only.
A mask indicating which state flags are valid; this is a bitlist of the flags reported above for the item state. See SetStateMask and GetStateMask().
A mask indicating which fields of this class are valid; see SetMask and GetMask. This is a bitlist of the following flags:
- LIST_MASK_STATE: The state field is valid.
- LIST_MASK_TEXT: The label field is valid.
- LIST_MASK_IMAGE: The image field is valid.
- LIST_MASK_DATA: The application-defined data field is valid.
- LIST_MASK_WIDTH: The column width field is valid.
- LIST_MASK_FORMAT: The column format field is valid.

The wx.ListItem object can also contain item-specific colour and font information: for this you need to call one of SetTextColour, SetBackgroundColour or SetFont functions on it passing it the colour/font to use. If the colour/font is not specified, the default list control colour/font is used.

Class Hierarchy¶

Inheritance diagram for class ListItem:

Methods Summary¶

`__init__`	Constructor.
`Clear`	Resets the item state to the default.
`GetAlign`	Returns the alignment for this item.
`GetBackgroundColour`	Returns the background colour for this item.
`GetColumn`	Returns the zero-based column; meaningful only in report mode.
`GetData`	Returns client data associated with the control.
`GetFont`	Returns the font used to display the item.
`GetId`	Returns the zero-based item position.
`GetImage`	Returns the zero-based index of the image associated with the item into the image list.
`GetMask`	Returns a bit mask indicating which fields of the structure are valid.
`GetState`	Returns a bit field representing the state of the item.
`GetText`	Returns the label/header text.
`GetTextColour`	Returns the text colour.
`GetWidth`	Meaningful only for column headers in report mode.
`SetAlign`	Sets the alignment for the item.
`SetBackgroundColour`	Sets the background colour for the item.
`SetColumn`	Sets the zero-based column.
`SetData`	Sets client data for the item.
`SetFont`	Sets the font for the item.
`SetId`	Sets the zero-based item position.
`SetImage`	Sets the zero-based index of the image associated with the item into the image list.
`SetMask`	Sets the mask of valid fields.
`SetState`	Sets the item state flags (note that the valid state flags are influenced by the value of the state mask, see `wx.ListItem.SetStateMask` ).
`SetStateMask`	Sets the bitmask that is used to determine which of the state flags are to be set.
`SetText`	Sets the text label for the item.
`SetTextColour`	Sets the text colour for the item.
`SetWidth`	Meaningful only for column headers in report mode.

Properties Summary¶

`Align`	See `GetAlign` and `SetAlign`
`BackgroundColour`	See `GetBackgroundColour` and `SetBackgroundColour`
`Column`	See `GetColumn` and `SetColumn`
`Data`	See `GetData` and `SetData`
`Font`	See `GetFont` and `SetFont`
`Id`	See `GetId` and `SetId`
`Image`	See `GetImage` and `SetImage`
`Mask`	See `GetMask` and `SetMask`
`State`	See `GetState` and `SetState`
`Text`	See `GetText` and `SetText`
`TextColour`	See `GetTextColour` and `SetTextColour`
`Width`	See `GetWidth` and `SetWidth`

Class API¶

class wx.ListItem(Object)¶

Possible constructors:

ListItem()

This class stores information about a ListCtrl item or column.

Methods¶

__init__(self)¶: Constructor.

Clear(self)¶: Resets the item state to the default.

GetAlign(self)¶

Returns the alignment for this item.

Can be one of LIST_FORMAT_LEFT , LIST_FORMAT_RIGHT or LIST_FORMAT_CENTRE .

Return type:	wx.ListColumnFormat

GetBackgroundColour(self)¶

Returns the background colour for this item.

Return type:	wx.Colour

GetColumn(self)¶

Returns the zero-based column; meaningful only in report mode.

Return type:	int

GetData(self)¶

Returns client data associated with the control.

Please note that client data is associated with the item and not with subitems.

Return type:	long

GetFont(self)¶

Returns the font used to display the item.

Return type:	wx.Font

GetId(self)¶

Returns the zero-based item position.

Return type:	long

GetImage(self)¶

Returns the zero-based index of the image associated with the item into the image list.

Return type:	int

GetMask(self)¶

Returns a bit mask indicating which fields of the structure are valid.

Can be any combination of the following values:

wx.LIST_MASK_STATE: GetState is valid.
wx.LIST_MASK_TEXT: GetText is valid.
wx.LIST_MASK_IMAGE: GetImage is valid.
wx.LIST_MASK_DATA: GetData is valid.
wx.LIST_MASK_WIDTH: GetWidth is valid.
wx.LIST_MASK_FORMAT: GetFormat is valid.

Return type:	long

GetState(self)¶

Returns a bit field representing the state of the item.

Can be any combination of:

wx.LIST_STATE_DONTCARE: Don’t care what the state is. Win32 only.
wx.LIST_STATE_DROPHILITED: The item is highlighted to receive a drop event. Win32 only.
wx.LIST_STATE_FOCUSED: The item has the focus.
wx.LIST_STATE_SELECTED: The item is selected.
wx.LIST_STATE_CUT: The item is in the cut state. Win32 only.