X-Git-Url: https://git.saurik.com/wxWidgets.git/blobdiff_plain/97722b262c50f7b317510c653b17f4b5a4f7e4b9..df83b840bbf6441a0166848d49a093557e562926:/docs/latex/wx/listctrl.tex diff --git a/docs/latex/wx/listctrl.tex b/docs/latex/wx/listctrl.tex index 3fdd794e97..67aa6b07c3 100644 --- a/docs/latex/wx/listctrl.tex +++ b/docs/latex/wx/listctrl.tex @@ -42,17 +42,16 @@ in \helpref{wxListEvent}{wxlistevent}. \twocolwidtha{7cm} \begin{twocollist}\itemsep=0pt -\twocolitem{\windowstyle{wxLC\_LIST}}{multicolumn list view, with optional small icons. +\twocolitem{\windowstyle{wxLC\_LIST}}{Multicolumn list view, with optional small icons. Columns are computed automatically, i.e. you don't set columns as in wxLC\_REPORT. In other words, the list wraps, unlike a wxListBox.} -\twocolitem{\windowstyle{wxLC\_REPORT}}{single or multicolumn report view, with optional header.} -\twocolitem{\windowstyle{wxLC\_VIRTUAL}}{virtual control, may only be used with wxLC\_REPORT} +\twocolitem{\windowstyle{wxLC\_REPORT}}{Single or multicolumn report view, with optional header.} +\twocolitem{\windowstyle{wxLC\_VIRTUAL}}{The application provides items text on demand. May only be used with wxLC\_REPORT.} \twocolitem{\windowstyle{wxLC\_ICON}}{Large icon view, with optional labels.} \twocolitem{\windowstyle{wxLC\_SMALL\_ICON}}{Small icon view, with optional labels.} \twocolitem{\windowstyle{wxLC\_ALIGN\_TOP}}{Icons align to the top. Win32 default, Win32 only. } \twocolitem{\windowstyle{wxLC\_ALIGN\_LEFT}}{Icons align to the left. } \twocolitem{\windowstyle{wxLC\_AUTOARRANGE}}{Icons arrange themselves. Win32 only. } -\twocolitem{\windowstyle{wxLC\_VIRTUAL}}{The application provides items text on demand.} \twocolitem{\windowstyle{wxLC\_EDIT\_LABELS}}{Labels are editable: the application will be notified when editing starts.} \twocolitem{\windowstyle{wxLC\_NO\_HEADER}}{No header in report mode. } \twocolitem{\windowstyle{wxLC\_SINGLE\_SEL}}{Single selection (default is multiple).} @@ -104,7 +103,7 @@ functions that take a \helpref{wxListEvent}{wxlistevent} argument. \latexignore{\rtfignore{\wxheading{Members}}} -\membersection{wxListCtrl::wxListCtrl}\label{wxlistctrlconstr} +\membersection{wxListCtrl::wxListCtrl}\label{wxlistctrlctor} \func{}{wxListCtrl}{\void} @@ -138,7 +137,7 @@ appropriately.} \helpref{wxListCtrl::Create}{wxlistctrlcreate}, \helpref{wxValidator}{wxvalidator} -\membersection{wxListCtrl::\destruct{wxListCtrl}} +\membersection{wxListCtrl::\destruct{wxListCtrl}}\label{wxlistctrldtor} \func{void}{\destruct{wxListCtrl}}{\void} @@ -187,7 +186,7 @@ Deletes all items and all columns. \param{const wxPoint\&}{ pos = wxDefaultPosition}, \param{const wxSize\&}{ size = wxDefaultSize},\rtfsp \param{long}{ style = wxLC\_ICON}, \param{const wxValidator\& }{validator = wxDefaultValidator}, \param{const wxString\& }{name = ``listCtrl"}} -Creates the list control. See \helpref{wxListCtrl::wxListCtrl}{wxlistctrlconstr} for further details. +Creates the list control. See \helpref{wxListCtrl::wxListCtrl}{wxlistctrlctor} for further details. \membersection{wxListCtrl::DeleteAllItems}\label{wxlistctrldeleteallitems} @@ -674,7 +673,7 @@ The base class version always returns $-1$. \membersection{wxListCtrl::OnGetItemText}\label{wxlistctrlongetitemtext} -\func{virtual wxString}{OnGetItemText}{\param{long }{item}, \param{long }{column}} +\constfunc{virtual wxString}{OnGetItemText}{\param{long }{item}, \param{long }{column}} This function {\bf must} be overloaded in the derived class for a control with {\tt wxLC\_VIRTUAL} style. It should return the string containing the text of @@ -809,12 +808,6 @@ The {\bf m\_mask} member contains a bitlist specifying which of the other fields The {\bf m\_stateMask} and {\bf m\_state} members take flags from the following: -The wxListItem object can also contain item-specific colour and font -information: for this you need to call one of SetTextColour(), -SetBackgroundColour() or SetFont() functions on it passing it the colour/font -to use. If the colour/font is not specified, the default list control -colour/font is used. - \twocolwidtha{5cm} \begin{twocollist}\itemsep=0pt \twocolitem{wxLIST\_STATE\_DONTCARE}{Don't care what the state is. Win32 only. } @@ -824,6 +817,12 @@ colour/font is used. \twocolitem{wxLIST\_STATE\_CUT}{The item is in the cut state. Win32 only. } \end{twocollist} +The wxListItem object can also contain item-specific colour and font +information: for this you need to call one of SetTextColour(), +SetBackgroundColour() or SetFont() functions on it passing it the colour/font +to use. If the colour/font is not specified, the default list control +colour/font is used. + \func{long}{SetItem}{\param{long }{index}, \param{int }{col}, \param{const wxString\& }{label}, \param{int }{imageId = -1}} Sets a string field at a particular column. @@ -868,17 +867,23 @@ Associates application-defined data with this item. \membersection{wxListCtrl::SetItemImage}\label{wxlistctrlsetitemimage} +\func{bool}{SetItemImage}{\param{long }{item}, \param{int }{image}} + +Sets the image associated with the item. The image is an index into the +image list associated with the list control. + \func{bool}{SetItemImage}{\param{long }{item}, \param{int }{image}, \param{int }{selImage}} Sets the unselected and selected images associated with the item. The images are indices into the -image list associated with the list control. +image list associated with the list control. This form is deprecated: {\it selImage} is not +used. \membersection{wxListCtrl::SetItemPosition}\label{wxlistctrlsetitemposition} \func{bool}{SetItemPosition}{\param{long }{item}, \param{const wxPoint\& }{pos}} -Sets the position of the item, in icon or small icon view. +Sets the position of the item, in icon or small icon view. Windows only. \membersection{wxListCtrl::SetItemState}\label{wxlistctrlsetitemstate}