[wxWidgets.git] / docs / latex / wx / node.tex

\section{\class{wxNode}}\label{wxnode}

wxNodeBase is the node structure used in linked lists (see 
\helpref{wxList}{wxlist}) and derived classes. You should never use wxNodeBase
class directly, however, because it works with untyped ({\tt void *}) data and
this is unsafe. Use wxNodeBase-derived classes which are automatically defined
by WX\_DECLARE\_LIST and WX\_DEFINE\_LIST macros instead as described in
\helpref{wxList}{wxlist} documentation (see example there). Also note that
although there is a class called wxNode, it is defined for backwards
compatibility only and usage of this class is strongly deprecated.

In the documentation below, the type {\tt T} should be thought of as a
``template'' parameter: this is the type of data stored in the linked list or,
in other words, the first argument of WX\_DECLARE\_LIST macro. Also, wxNode is
written as wxNode<T> even though it isn't really a template class -- but it
helps to think of it as if it were.

\wxheading{Derived from}

None.

\wxheading{Include files}

<wx/list.h>

\wxheading{See also}

\helpref{wxList}{wxlist}, \helpref{wxHashTable}{wxhashtable}

\latexignore{\rtfignore{\wxheading{Members}}}

\membersection{wxNode<T>::GetData}\label{wxnodegetdata}

\constfunc{T *}{GetData}{\void}

Retrieves the client data pointer associated with the node.

\membersection{wxNode<T>::GetNext}\label{wxnodegetnext}

\constfunc{wxNode<T> *}{GetNext}{\void}

Retrieves the next node or NULL if this node is the last one.

\membersection{wxNode<T>::GetPrevious}\label{wxnodegetprevious}

\func{wxNode<T> *}{GetPrevious}{\void}

Retrieves the previous node or NULL if this node is the first one in the list.

\membersection{wxNode<T>::SetData}\label{wxnodesetdata}

\func{void}{SetData}{\param{T *}{data}}

Sets the data associated with the node (usually the pointer will have been
set when the node was created).

\membersection{wxNode<T>::IndexOf}\label{wxnodeindexof}

\func{int}{IndexOf}{\void}

Returns the zero-based index of this node within the list. The return value
will be {\tt wxNOT\_FOUND} if the node has not been added to a list yet.
Commit	Line	Data
2b5f62a0 VZ	1	\section{\class{wxNode}}\label{wxnode}
	2
	3	wxNodeBase is the node structure used in linked lists (see
	4	\helpref{wxList}{wxlist}) and derived classes. You should never use wxNodeBase
	5	class directly, however, because it works with untyped ({\tt void *}) data and
	6	this is unsafe. Use wxNodeBase-derived classes which are automatically defined
	7	by WX\_DECLARE\_LIST and WX\_DEFINE\_LIST macros instead as described in
	8	\helpref{wxList}{wxlist} documentation (see example there). Also note that
	9	although there is a class called wxNode, it is defined for backwards
	10	compatibility only and usage of this class is strongly deprecated.
	11
	12	In the documentation below, the type {\tt T} should be thought of as a
	13	``template'' parameter: this is the type of data stored in the linked list or,
	14	in other words, the first argument of WX\_DECLARE\_LIST macro. Also, wxNode is
	15	written as wxNode<T> even though it isn't really a template class -- but it
	16	helps to think of it as if it were.
a660d684 KB	17
	18	\wxheading{Derived from}
	19
6e6110ee	20	None.
a660d684	21
954b8ae6 JS	22	\wxheading{Include files}
	23
	24	<wx/list.h>
	25
a660d684 KB	26	\wxheading{See also}
	27
	28	\helpref{wxList}{wxlist}, \helpref{wxHashTable}{wxhashtable}
	29
	30	\latexignore{\rtfignore{\wxheading{Members}}}
	31
dcbd177f	32	\membersection{wxNode<T>::GetData}\label{wxnodegetdata}
a660d684	33
2b5f62a0	34	\constfunc{T *}{GetData}{\void}
a660d684	35
6e6110ee	36	Retrieves the client data pointer associated with the node.
a660d684	37
dcbd177f	38	\membersection{wxNode<T>::GetNext}\label{wxnodegetnext}
a660d684	39
2b5f62a0	40	\constfunc{wxNode<T> *}{GetNext}{\void}
a660d684	41
2b5f62a0	42	Retrieves the next node or NULL if this node is the last one.
a660d684	43
dcbd177f	44	\membersection{wxNode<T>::GetPrevious}\label{wxnodegetprevious}
a660d684	45
2b5f62a0	46	\func{wxNode<T> *}{GetPrevious}{\void}
a660d684	47
2b5f62a0	48	Retrieves the previous node or NULL if this node is the first one in the list.
a660d684	49
dcbd177f	50	\membersection{wxNode<T>::SetData}\label{wxnodesetdata}
a660d684	51
2b5f62a0	52	\func{void}{SetData}{\param{T *}{data}}
a660d684 KB	53
	54	Sets the data associated with the node (usually the pointer will have been
	55	set when the node was created).
	56
dcbd177f	57	\membersection{wxNode<T>::IndexOf}\label{wxnodeindexof}
77c5eefb VZ	58
	59	\func{int}{IndexOf}{\void}
	60
	61	Returns the zero-based index of this node within the list. The return value
a8d08dbd	62	will be {\tt wxNOT\_FOUND} if the node has not been added to a list yet.
a660d684	63