git.saurik.com Git - wxWidgets.git/blame_incremental

... / ...

Commit	Line	Data
	1	\section{\class{wxListEvent}}\label{wxlistevent}
	2
	3	A list event holds information about events associated with wxListCtrl objects.
	4
	5	\wxheading{Derived from}
	6
	7	\helpref{wxNotifyEvent}{wxnotifyevent}\\
	8	\helpref{wxCommandEvent}{wxcommandevent}\\
	9	\helpref{wxEvent}{wxevent}\\
	10	\helpref{wxObject}{wxobject}
	11
	12	\wxheading{Include files}
	13
	14	<wx/listctrl.h>
	15
	16	\wxheading{Event table macros}
	17
	18	To process input from a list control, use these event handler macros to direct input to member
	19	functions that take a wxListEvent argument.
	20
	21	\twocolwidtha{7cm}
	22	\begin{twocollist}\itemsep=0pt
	23	\twocolitem{{\bf EVT\_LIST\_BEGIN\_DRAG(id, func)}}{Begin dragging with the left mouse button.}
	24	\twocolitem{{\bf EVT\_LIST\_BEGIN\_RDRAG(id, func)}}{Begin dragging with the right mouse button.}
	25	\twocolitem{{\bf EVT\_LIST\_BEGIN\_LABEL\_EDIT(id, func)}}{Begin editing a label. This can be prevented by calling \helpref{Veto()}{wxnotifyeventveto}.}
	26	\twocolitem{{\bf EVT\_LIST\_END\_LABEL\_EDIT(id, func)}}{Finish editing a label. This can be prevented by calling \helpref{Veto()}{wxnotifyeventveto}.}
	27	\twocolitem{{\bf EVT\_LIST\_DELETE\_ITEM(id, func)}}{Delete an item.}
	28	\twocolitem{{\bf EVT\_LIST\_DELETE\_ALL\_ITEMS(id, func)}}{Delete all items.}
	29	%\twocolitem{{\bf EVT\_LIST\_GET\_INFO(id, func)}}{Request information from the application, usually the item text.}
	30	%\twocolitem{{\bf EVT\_LIST\_SET\_INFO(id, func)}}{Information is being supplied (not implemented).}
	31	\twocolitem{{\bf EVT\_LIST\_ITEM\_SELECTED(id, func)}}{The item has been selected.}
	32	\twocolitem{{\bf EVT\_LIST\_ITEM\_DESELECTED(id, func)}}{The item has been deselected.}
	33	\twocolitem{{\bf EVT\_LIST\_ITEM\_ACTIVATED(id, func)}}{The item has been activated (ENTER or double click).}
	34	\twocolitem{{\bf EVT\_LIST\_ITEM\_RIGHT\_CLICK(id, func)}}{An item has been right-clicked.}
	35	\twocolitem{{\bf EVT\_LIST\_KEY\_DOWN(id, func)}}{A key has been pressed.}
	36	\twocolitem{{\bf EVT\_LIST\_INSERT\_ITEM(id, func)}}{An item has been inserted.}
	37	\twocolitem{{\bf EVT\_LIST\_COL\_CLICK(id, func)}}{A column ({\bf m\_col}) has been left-clicked.}
	38	\twocolitem{{\bf EVT\_LIST\_COL\_RIGHT\_CLICK(id, func)}}{A column ({\bf m\_col}) has been right-clicked.}
	39	\twocolitem{{\bf EVT\_LIST\_COL\_BEGIN\_DRAG(id, func)}}{The user started resizing a column - can be vetoed.}
	40	\twocolitem{{\bf EVT\_LIST\_COL\_DRAGGING(id, func)}}{The divider between columns is being dragged.}
	41	\twocolitem{{\bf EVT\_LIST\_COL\_END\_DRAG(id, func)}}{A column has been resized by the user.}
	42	\twocolitem{{\bf EVT\_LIST\_CACHE\_HINT(id, func)}}{Prepare cache for a virtual list control}
	43	\end{twocollist}%
	44
	45	\wxheading{See also}
	46
	47	\helpref{wxListCtrl}{wxlistctrl}
	48
	49	\latexignore{\rtfignore{\wxheading{Members}}}
	50
	51	\membersection{wxListEvent::wxListEvent}
	52
	53	\func{}{wxListEvent}{\param{WXTYPE }{commandType = 0}, \param{int }{id = 0}}
	54
	55	Constructor.
	56
	57	\membersection{wxListEvent::GetCacheFrom}\label{wxlisteventgetcachefrom}
	58
	59	\constfunc{long}{GetCacheFrom}{\void}
	60
	61	For {\tt EVT\_LIST\_CACHE\_HINT} event only: return the first item which the
	62	list control advises us to cache.
	63
	64	\membersection{wxListEvent::GetCacheTo}\label{wxlisteventgetcacheto}
	65
	66	\constfunc{long}{GetCacheTo}{\void}
	67
	68	For {\tt EVT\_LIST\_CACHE\_HINT} event only: return the last item (inclusive)
	69	which the list control advises us to cache.
	70
	71	\membersection{wxListEvent::GetCode}\label{wxlisteventgetcode}
	72
	73	\constfunc{int}{GetCode}{\void}
	74
	75	Key code if the event is a keypress event.
	76
	77	\membersection{wxListEvent::GetIndex}\label{wxlisteventgetindex}
	78
	79	\constfunc{long}{GetIndex}{\void}
	80
	81	The item index.
	82
	83	\membersection{wxListEvent::GetOldIndex}\label{wxlisteventgetoldindex}
	84
	85	\constfunc{long}{GetOldIndex}{\void}
	86
	87	The old item index.
	88
	89	\membersection{wxListEvent::GetColumn}\label{wxlisteventgetcolumn}
	90
	91	\constfunc{int}{GetColumn}{\void}
	92
	93	The column position: it is only used with {\tt COL} events. For the column
	94	dragging events, it is the column to the left of the divider being dragged, for
	95	the column click events it may be $-1$ if the user clicked in the list control
	96	header outside any column.
	97
	98	\membersection{wxListEvent::Cancelled}\label{wxlisteventcancelled}
	99
	100	\constfunc{bool}{Cancelled}{\void}
	101
	102	TRUE if this event is an end edit event and the user cancelled the edit.
	103
	104	\membersection{wxListEvent::GetPoint}\label{wxlisteventgetpoint}
	105
	106	\constfunc{wxPoint}{GetPoint}{\void}
	107
	108	The position of the mouse pointer if the event is a drag event.
	109
	110
	111	\membersection{wxListEvent::GetLabel}\label{wxlisteventgetlabel}
	112
	113	\constfunc{const wxString\&}{GetLabel}{\void}
	114
	115	The label.
	116
	117	\membersection{wxListEvent::GetText}\label{wxlisteventgettext}
	118
	119	\constfunc{const wxString\&}{GetText}{\void}
	120
	121	The text.
	122
	123	\membersection{wxListEvent::GetImage}\label{wxlisteventgetimage}
	124
	125	\constfunc{int}{GetImage}{\void}
	126
	127	The image.
	128
	129	\membersection{wxListEvent::GetData}\label{wxlisteventgetdata}
	130
	131	\constfunc{long}{GetData}{\void}
	132
	133	The data.
	134
	135	\membersection{wxListEvent::GetMask}\label{wxlisteventgetmask}
	136
	137	\constfunc{long}{GetMask}{\void}
	138
	139	The mask.
	140
	141	\membersection{wxListEvent::GetItem}\label{wxlisteventgetitem}
	142
	143	\constfunc{const wxListItem\&}{GetItem}{\void}
	144
	145	An item object, used by some events. See also \helpref{wxListCtrl::SetItem}{wxlistctrlsetitem}.
	146
	147