## wxListItem

This class stores information about a wxListCtrl item or column.

Derived from

wxObject

Include files

<wx/listctrl.h>

Members

wxListItem::wxListItem
wxListItem::Clear
wxListItem::GetAlign
wxListItem::GetBackgroundColour
wxListItem::GetColumn
wxListItem::GetData
wxListItem::GetFont
wxListItem::GetId
wxListItem::GetImage
wxListItem::GetMask
wxListItem::GetState
wxListItem::GetText
wxListItem::GetTextColour
wxListItem::GetWidth
wxListItem::SetAlign
wxListItem::SetBackgroundColour
wxListItem::SetColumn
wxListItem::SetData
wxListItem::SetFont
wxListItem::SetId
wxListItem::SetImage
wxListItem::SetMask
wxListItem::SetState
wxListItem::SetStateMask
wxListItem::SetText
wxListItem::SetTextColour
wxListItem::SetWidth

### wxListItem::wxListItem

wxListItem()

Constructor.

### wxListItem::Clear

void Clear()

Resets the item state to the default.

### wxListItem::GetAlign

wxListColumnFormat GetAlign() const

Returns the alignment for this item. Can be one of wxLIST_FORMAT_LEFT, wxLIST_FORMAT_RIGHT or wxLIST_FORMAT_CENTRE.

### wxListItem::GetBackgroundColour

wxColour GetBackgroundColour() const

Returns the background colour for this item.

### wxListItem::GetColumn

int GetColumn() const

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

### wxListItem::GetData

long GetData() const

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

### wxListItem::GetFont

wxFont GetFont() const

Returns the font used to display the item.

### wxListItem::GetId

long GetId() const

Returns the zero-based item position.

### wxListItem::GetImage

int GetImage() const

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

### wxListItem::GetMask

long GetMask() const

Returns a bit mask indicating which fields of the structure are valid; can be any combination of the following values:

wxLIST_MASK_STATE | GetState is valid.
wxLIST_MASK_TEXT | GetText is valid.
wxLIST_MASK_IMAGE | GetImage is valid.
wxLIST_MASK_DATA | GetData is valid.
wxLIST_MASK_WIDTH | GetWidth is valid.
wxLIST_MASK_FORMAT | GetFormat is valid.

### wxListItem::GetState

long GetState() const

Returns a bit field representing the state of the item. Can be any combination of:

wxLIST_STATE_DONTCARE | Don't care what the state is. Win32 only.
wxLIST_STATE_DROPHILITED | The item is highlighted to receive a drop event. Win32 only.
wxLIST_STATE_FOCUSED | The item has the focus.
wxLIST_STATE_SELECTED | The item is selected.
wxLIST_STATE_CUT | The item is in the cut state. Win32 only.

### wxListItem::GetText

const wxString& GetText() const

Returns the label/header text.

### wxListItem::GetTextColour

wxColour GetTextColour() const

Returns the text colour.

### wxListItem::GetWidth

int GetWidth() const

Meaningful only for column headers in report mode. Returns the column width.

### wxListItem::SetAlign

void SetAlign(wxListColumnFormat align)

Sets the alignment for the item. See also wxListItem::GetAlign

### wxListItem::SetBackgroundColour

void SetBackgroundColour(const wxColour& colBack)

Sets the background colour for the item.

### wxListItem::SetColumn

void SetColumn(int col)

Sets the zero-based column. Meaningful only in report mode.

### wxListItem::SetData

void SetData(long data)

void SetData(void* data)

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

### wxListItem::SetFont

void SetFont(const wxFont& font)

Sets the font for the item.

### wxListItem::SetId

void SetId(long id)

Sets the zero-based item position.

### wxListItem::SetImage

void SetImage(int image)

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

### wxListItem::SetMask

void SetMask(long mask)

Sets the mask of valid fields. See wxListItem::GetMask.

### wxListItem::SetState

void SetState(long state)

Sets the item state flags (note that the valid state flags are influenced by the value of the state mask, see wxListItem::SetStateMask). See wxListItem::GetState for valid flag values.

### wxListItem::SetStateMask

void SetStateMask(long stateMask)

Sets the bitmask that is used to determine which of the state flags are to be set. See also wxListItem::SetState.

### wxListItem::SetText

void SetText(const wxString& text)

Sets the text label for the item.

### wxListItem::SetTextColour

void SetTextColour(const wxColour& colText)

Sets the text colour for the item.

### wxListItem::SetWidth

void SetWidth(int width)

Meaningful only for column headers in report mode. Sets the column width.