wxListView

This class currently simply presents a simpler to use interface for the wxListCtrl - it can be thought of as a façade for that complicated class. Using it is preferable to using wxListCtrl directly whenever possible because in the future some ports might implement wxListView but not the full set of wxListCtrl features.

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

Derived from

wxListCtrl
wxControl
wxWindow
wxEvtHandler
wxObject

Include files

<wx/listctrl.h>



wxListView::ClearColumnImage



void ClearColumnImage(int col)

Resets the column image - after calling this function, no image will be shown.

Parameters

col
the column to clear image for

See also

SetColumnImage



wxListView::Focus



void Focus(long index)

Sets focus to the item with the given index.



wxListView::GetFirstSelected

long GetFirstSelected(void) const

Returns the first selected item in a (presumably) multiple selection control. Tigether with GetNextSelected it can be used to iterate over all selected items in the control.

Return value

The fisrt selected item, if any, $-1$ otherwise.



wxListView::GetFocusedItem

long GetFocusedItem(void) const

Returns the currently focused item or $-1$ if none.

See also

IsSelected,
Focus



wxListView::GetNextSelected

long GetNextSelected(long item) const

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

Return value

Returns the next selected item or $-1$ if there are no more of them.



wxListView::IsSelected



bool IsSelected(long index)

Returns true if the item with the given index is selected, false otherwise.

See also

GetFirstSelected,
GetNextSelected



wxListView::Select



void Select(long n, bool on = true)

Selects or unselects the given item.

Parameters

n
the item to select or unselect

on
if true (default), selects the item, otherwise unselects it

See also

SetItemState



wxListView::SetColumnImage



void SetColumnImage(int col, int 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
the column to set image for

image
the index of the column image in the controls image list

See also

ClearColumnImage,
SetImageList

ymasuda 平成17年11月19日