this class stores information about a wxlistctrl item or column.
derived from
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()
constructor.
void clear()
resets the item state to the default.
wxlistcolumnformat getalign() const
returns the alignment for this item. can be one of wxlist_format_left, wxlist_format_right or wxlist_format_centre.
wxcolour getbackgroundcolour() const
returns the background colour for this item.
int getcolumn() const
returns the zero-based column; meaningful only in report mode.
long getdata() const
returns client data associated with the control. please note that client data is associated with the item and not with subitems.
wxfont getfont() const
returns the font used to display the item.
long getid() const
returns the zero-based item position.
int getimage() const
returns the zero-based index of the image associated with the item into the image list.
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. |
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. |
const wxstring& gettext() const
returns the label/header text.
wxcolour gettextcolour() const
returns the text colour.
int getwidth() const
meaningful only for column headers in report mode. returns the column width.
void setalign(wxlistcolumnformat align)
sets the alignment for the item. see also wxlistitem::getalign
void setbackgroundcolour(const wxcolour& colback)
sets the background colour for the item.
void setcolumn(int col)
sets the zero-based column. meaningful only in report mode.
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.
void setfont(const wxfont& font)
sets the font for the item.
void setid(long id)
sets the zero-based item position.
void setimage(int image)
sets the zero-based index of the image associated with the item into the image list.
void setmask(long mask)
sets the mask of valid fields. see wxlistitem::getmask.
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.
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.
void settext(const wxstring& text)
sets the text label for the item.
void settextcolour(const wxcolour& coltext)
sets the text colour for the item.
void setwidth(int width)
meaningful only for column headers in report mode. sets the column width.