From 08a87680c5351968904c4934d120edf632562e6e Mon Sep 17 00:00:00 2001
From: Mattia Barbon <mbarbon@cpan.org>
Date: Wed, 8 May 2002 19:57:52 +0000
Subject: [PATCH] Added documentation for wxListItem. Still need to strip the
 one in wxListCtrl::SetItem, or better move it to listitem,tex+mark it
 obsolete.

git-svn-id: https://svn.wxwidgets.org/svn/wx/wxWidgets/trunk@15441 c3d73ce0-8a6f-49c7-b76d-6d57e0e08775
---
 docs/latex/wx/classes.tex  |   1 +
 docs/latex/wx/listctrl.tex |   3 +-
 docs/latex/wx/listitem.tex | 258 +++++++++++++++++++++++++++++++++++++
 3 files changed, 261 insertions(+), 1 deletion(-)
 create mode 100644 docs/latex/wx/listitem.tex

diff --git a/docs/latex/wx/classes.tex b/docs/latex/wx/classes.tex
index a164c23df0..05538a8948 100644
--- a/docs/latex/wx/classes.tex
+++ b/docs/latex/wx/classes.tex
@@ -181,6 +181,7 @@
 \input listbox.tex
 \input listctrl.tex
 \input listevt.tex
+\input listitem.tex
 % Deprecated
 %\input proplosv.tex
 \input locale.tex
diff --git a/docs/latex/wx/listctrl.tex b/docs/latex/wx/listctrl.tex
index 6466cd44b7..b837842541 100644
--- a/docs/latex/wx/listctrl.tex
+++ b/docs/latex/wx/listctrl.tex
@@ -93,7 +93,8 @@ functions that take a \helpref{wxListEvent}{wxlistevent} argument.
 \wxheading{See also}
 
 \helpref{wxListCtrl overview}{wxlistctrloverview}, \helpref{wxListBox}{wxlistbox}, \helpref{wxTreeCtrl}{wxtreectrl},\rtfsp
-\helpref{wxImageList}{wximagelist}, \helpref{wxListEvent}{wxlistevent}
+\helpref{wxImageList}{wximagelist}, \helpref{wxListEvent}{wxlistevent},
+\helpref{wxListItem}{wxlistitem}
 
 \latexignore{\rtfignore{\wxheading{Members}}}
 
diff --git a/docs/latex/wx/listitem.tex b/docs/latex/wx/listitem.tex
new file mode 100644
index 0000000000..0cd02ffbbc
--- /dev/null
+++ b/docs/latex/wx/listitem.tex
@@ -0,0 +1,258 @@
+\section{\class{wxListItem}}\label{wxlistitem}
+
+This class stores information about a wxListCtrl item or column.
+
+\wxheading{Derived from}
+
+\helpref{wxObject}{wxobject}
+
+\wxheading{Include files}
+
+<wx/listctrl.h>
+
+\latexignore{\rtfignore{\wxheading{Members}}}
+
+\membersection{wxListItem::wxListItem}\label{wxlistitemwxlistitem}
+
+\func{}{wxListItem}{\void}
+
+Constructor.
+
+\membersection{wxListItem::Clear}\label{wxlistitemclear}
+
+\func{void}{Clear}{\void}
+
+Resets the item state to the default.
+
+
+
+\membersection{wxListItem::GetAlign}\label{wxlistitemgetalign}
+
+\constfunc{wxListColumnFormat}{GetAlign}{\void}
+
+Returns the alignment for this item. Can be one of
+wxLIST\_FORMAT\_LEFT, wxLIST\_FORMAT\_RIGHT or wxLIST\_FORMAT\_CENTRE.
+
+
+
+\membersection{wxListItem::GetBackgroundColour}\label{wxlistitemgetbackgroundcolour}
+
+\constfunc{wxColour}{GetBackgroundColour}{\void}
+
+Returns the background colour for this item.
+
+
+
+\membersection{wxListItem::GetColumn}\label{wxlistitemgetcolumn}
+
+\constfunc{int}{GetColumn}{\void}
+
+Returns the zero-based column; meaningful only in report mode.
+
+
+
+\membersection{wxListItem::GetData}\label{wxlistitemgetdata}
+
+\constfunc{long}{GetData}{\void}
+
+Returns client data associated with the control.
+
+
+
+\membersection{wxListItem::GetFont}\label{wxlistitemgetfont}
+
+\constfunc{wxFont}{GetFont}{\void}
+
+Returns the font used to display the item.
+
+
+
+\membersection{wxListItem::GetId}\label{wxlistitemgetid}
+
+\constfunc{long}{GetId}{\void}
+
+Returns the zero-based item position.
+
+
+
+\membersection{wxListItem::GetImage}\label{wxlistitemgetimage}
+
+\constfunc{int}{GetImage}{\void}
+
+Returns the zero-based index of the image
+associated with the item into the image list.
+
+
+
+\membersection{wxListItem::GetMask}\label{wxlistitemgetmask}
+
+\constfunc{long}{GetMask}{\void}
+
+Returns a bit mask indicating which fields of the structure are valid;
+can be any combination of the following values:
+
+\twocolwidtha{5cm}
+\begin{twocollist}\itemsep=0pt
+\twocolitem{wxLIST\_MASK\_STATE}{The {\bf GetState} is valid.}
+\twocolitem{wxLIST\_MASK\_TEXT}{The {\bf GetText} is valid.}
+\twocolitem{wxLIST\_MASK\_IMAGE}{The {\bf GetImage} is valid.}
+\twocolitem{wxLIST\_MASK\_DATA}{The {\bf GetData} is valid.}
+\twocolitem{wxLIST\_MASK\_WIDTH}{The {\bf GetWidth} is valid.}
+\twocolitem{wxLIST\_MASK\_FORMAT}{The {\bf GetAlign} is valid.}
+\end{twocollist}
+
+
+
+\membersection{wxListItem::GetState}\label{wxlistitemgetstate}
+
+\constfunc{long}{GetState}{\void}
+
+Returns a bit field representing the state of the item. Can be any
+combination of:
+
+\twocolwidtha{5cm}
+\begin{twocollist}\itemsep=0pt
+\twocolitem{wxLIST\_STATE\_DONTCARE}{Don't care what the state is. Win32 only. }
+\twocolitem{wxLIST\_STATE\_DROPHILITED}{The item is highlighted to receive a drop event. Win32 only. }
+\twocolitem{wxLIST\_STATE\_FOCUSED}{The item has the focus.}
+\twocolitem{wxLIST\_STATE\_SELECTED}{The item is selected.}
+\twocolitem{wxLIST\_STATE\_CUT}{The item is in the cut state. Win32 only. }
+\end{twocollist}
+
+
+
+\membersection{wxListItem::GetText}\label{wxlistitemgettext}
+
+\constfunc{const wxString\&}{GetText}{\void}
+
+Returns the label/header text.
+
+
+
+\membersection{wxListItem::GetTextColour}\label{wxlistitemgettextcolour}
+
+\constfunc{wxColour}{GetTextColour}{\void}
+
+Returns the text colour.
+
+
+
+\membersection{wxListItem::GetWidth}\label{wxlistitemgetwidth}
+
+\constfunc{int}{GetWidth}{\void}
+
+Meaningful only for column headers in report mode. Returns the column width.
+
+
+
+\membersection{wxListItem::SetAlign}\label{wxlistitemsetalign}
+
+\func{void}{SetAlign}{\param{wxListColumnFormat }{align}}
+
+Sets the alignment for the item. See also
+\helpref{wxListItem::SetAlign}{wxlistitemsetalign}
+
+
+
+\membersection{wxListItem::SetBackgroundColour}\label{wxlistitemsetbackgroundcolour}
+
+\func{void}{SetBackgroundColour}{\param{const wxColour\& }{colBack}}
+
+Sets the background colour for the item.
+
+
+
+\membersection{wxListItem::SetColumn}\label{wxlistitemsetcolumn}
+
+\func{void}{SetColumn}{\param{int }{col}}
+
+Sets the zer-based column. Meaningful only in report mode.
+
+
+
+\membersection{wxListItem::SetData}\label{wxlistitemsetdata}
+
+\func{void}{SetData}{\param{long }{data}}
+
+\func{void}{SetData}{\param{void* }{data}}
+
+Sets client data for the item.
+
+
+
+\membersection{wxListItem::SetFont}\label{wxlistitemsetfont}
+
+\func{void}{SetFont}{\param{const wxFont\& }{font}}
+
+Sets the font for the item.
+
+
+
+\membersection{wxListItem::SetId}\label{wxlistitemsetid}
+
+\func{void}{SetId}{\param{long }{id}}
+
+Sets the zero-based item position.
+
+
+
+\membersection{wxListItem::SetImage}\label{wxlistitemsetimage}
+
+\func{void}{SetImage}{\param{int }{image}}
+
+Returns the zero-based index of the image associated with the item
+into the image list.
+
+
+
+\membersection{wxListItem::SetMask}\label{wxlistitemsetmask}
+
+\func{void}{SetMask}{\param{long }{mask}}
+
+Sets the mask of valid fields. See
+\helpref{wxListItem::SetMask}{wxlistitemsetmask}.
+
+
+
+\membersection{wxListItem::SetState}\label{wxlistitemsetstate}
+
+\func{void}{SetState}{\param{long }{state}}
+
+Sets the item state flags (note that the valid state flags are influenced
+by the value of the state mask, see
+\helpref{wxListItem::SetStateMask}{wxlistitemsetstatemask}).
+See \helpref{wxListItem::GetState}{wxlistitemsetstate} for valid flag
+values.
+
+
+
+\membersection{wxListItem::SetStateMask}\label{wxlistitemsetstatemask}
+
+\func{void}{SetStateMask}{\param{long }{stateMask}}
+
+Sets the bitmask that is used to determine which of the state flags
+are to be set. See also \helpref{wxListItem::SetState}{wxlistitemsetstate}.
+
+
+
+\membersection{wxListItem::SetText}\label{wxlistitemsettext}
+
+\func{void}{SetText}{\param{const wxString\& }{text}}
+
+Sets the text label for the item.
+
+
+
+\membersection{wxListItem::SetTextColour}\label{wxlistitemsettextcolour}
+
+\func{void}{SetTextColour}{\param{const wxColour\& }{colText}}
+
+Sets the text colour for the item.
+
+
+
+\membersection{wxListItem::SetWidth}\label{wxlistitemsetwidth}
+
+\func{void}{SetWidth}{\param{int }{width}}
+
+Meaningful only for column headers in report mode. Sets the column width.
-- 
2.50.0

