X-Git-Url: https://git.saurik.com/wxWidgets.git/blobdiff_plain/314cd032db3c77e6d17a692b5cdde8bb77a4342d..81c882b613b5d99ddb1e5ab69fcd7ebccc287025:/docs/latex/wx/dataviewctrl.tex?ds=sidebyside diff --git a/docs/latex/wx/dataviewctrl.tex b/docs/latex/wx/dataviewctrl.tex index 2c0688b0cd..cf373d73cf 100644 --- a/docs/latex/wx/dataviewctrl.tex +++ b/docs/latex/wx/dataviewctrl.tex @@ -2,11 +2,13 @@ \section{\class{wxDataViewCtrl}}\label{wxdataviewctrl} This class and its documentation are work in progress and -certainly subject to change. +therefore subject to change. wxDataViewCtrl is planned to be a control to display data either -in a tree like fashion or in a tabular form or both. Currently, -only the tabular form is implemented. wxDataViewCtrl doesn't +in a tree like fashion or in a tabular form or both. So far, +only the tabular form is implemented. + +Unlike \helpref{wxListCtrl}{wxlistctrl} wxDataViewCtrl doesn't get its data from the user through virtual functions or events, instead you need to write your own \helpref{wxDataViewListModel}{wxdataviewlistmodel} and associate @@ -27,10 +29,11 @@ be extended to support more data formats as necessary. Accordingly, all type information uses the strings returned from \helpref{wxVariant::GetType}{wxvariantgettype}. -So far, this control has only be implemented for GTK+ and -there are only barely working stubs for a generic implementation. -It is planned to implement the control natively under OS X -and use generic code under Windows (and elsewhere). +So far, this control has been implemented for GTK+ and there +is an almost complete generic implementation including several +additions for a native Windows look and feel (in particular +concerning the header). It is planned to implement the control +natively under OS X. \wxheading{Window styles} @@ -57,6 +60,24 @@ macros to direct input to member functions that take a \end{twocollist} +Additionally, you can get informed about changes to the +\helpref{model}{wxDataViewListModel}, to which a wxDataViewCtrl +has been associated. These events correspond to the interface +offered by \helpref{wxDataViewListModelNotifier}{wxdataviewlistmodelnotifier}. + +\twocolwidtha{7cm} +\begin{twocollist}\itemsep=0pt + +\twocolitem{{\bf EVT\_DATAVIEW\_MODEL\_ROW\_PREPENDED(id, func)}}{Processes a wxEVT\_COMMAND\_DATAVIEW\_MODEL\_ROW\_PREPENDED event.} +\twocolitem{{\bf EVT\_DATAVIEW\_MODEL\_ROW\_APPENDED(id, func)}}{Processes a wxEVT\_COMMAND\_DATAVIEW\_MODEL\_ROW\_APPENDED event.} +\twocolitem{{\bf EVT\_DATAVIEW\_MODEL\_ROW\_INSERTED(id, func)}}{Processes a wxEVT\_COMMAND\_DATAVIEW\_MODEL\_ROW\_INSERTED event.} +\twocolitem{{\bf EVT\_DATAVIEW\_MODEL\_ROW\_DELETED(id, func)}}{Processes a wxEVT\_COMMAND\_DATAVIEW\_MODEL\_ROW\_DELETED event.} +\twocolitem{{\bf EVT\_DATAVIEW\_MODEL\_ROW\_CHANGED(id, func)}}{Processes a wxEVT\_COMMAND\_DATAVIEW\_MODEL\_ROW\_CHANGED event.} +\twocolitem{{\bf EVT\_DATAVIEW\_MODEL\_VALUE\_CHANGED(id, func)}}{Processes a wxEVT\_COMMAND\_DATAVIEW\_MODEL\_VALUE\_CHANGED event.} +\twocolitem{{\bf EVT\_DATAVIEW\_MODEL\_ROWS\_REORDERED(id, func)}}{Processes a wxEVT\_COMMAND\_DATAVIEW\_MODEL\_ROWS\_REORDERED event.} +\twocolitem{{\bf EVT\_DATAVIEW\_MODEL\_CLEARED(id, func)}}{Processes a wxEVT\_COMMAND\_DATAVIEW\_MODEL\_CLEARED event.} + +\end{twocollist} \wxheading{Derived from} @@ -177,9 +198,9 @@ Returns pointer to the column. Returns pointer to the data model associated with the control (if any). -\membersection{wxDataViewCtrl::GetNumberOfColumns}\label{wxdataviewctrlgetnumberofcolumns} +\membersection{wxDataViewCtrl::GetColumnCount}\label{wxdataviewctrlgetcolumncount} -\func{virtual unsigned int}{GetNumberOfColumns}{\void} +\func{virtual unsigned int}{GetColumnCount}{\void} Returns the number of columns.