phoenix_title 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: No special flags (the value of this constant is 0).

    • 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.

See also

wx.ListCtrl


class_hierarchy Class Hierarchy

Inheritance diagram for class ListItem:

method_summary 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.


property_summary 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


api 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: No special flags (the values of this constant is 0).

  • 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.

Return type:

long



GetText(self)

Returns the label/header text.

Return type:

string



GetTextColour(self)

Returns the text colour.

Return type:

wx.Colour



GetWidth(self)

Meaningful only for column headers in report mode.

Returns the column width.

Return type:

int



SetAlign(self, align)

Sets the alignment for the item.

See also GetAlign

Parameters:

align (ListColumnFormat) –



SetBackgroundColour(self, colBack)

Sets the background colour for the item.

Parameters:

colBack (wx.Colour) –



SetColumn(self, col)

Sets the zero-based column.

Meaningful only in report mode.

Parameters:

col (int) –



SetData(self, data)

Sets client data for the item.

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

Parameters:

data (long) –



SetFont(self, font)

Sets the font for the item.

Parameters:

font (wx.Font) –



SetId(self, id)

Sets the zero-based item position.

Parameters:

id (long) –



SetImage(self, image)

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

Parameters:

image (int) –



SetMask(self, mask)

Sets the mask of valid fields.

See GetMask .

Parameters:

mask (long) –



SetState(self, state)

Sets the item state flags (note that the valid state flags are influenced by the value of the state mask, see wx.ListItem.SetStateMask ).

See GetState for valid flag values.

Parameters:

state (long) –



SetStateMask(self, stateMask)

Sets the bitmask that is used to determine which of the state flags are to be set.

See also SetState .

Parameters:

stateMask (long) –



SetText(self, text)

Sets the text label for the item.

Parameters:

text (string) –



SetTextColour(self, colText)

Sets the text colour for the item.

Parameters:

colText (wx.Colour) –



SetWidth(self, width)

Meaningful only for column headers in report mode.

Sets the column width.

Parameters:

width (int) –


Properties

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