]> git.saurik.com Git - wxWidgets.git/blobdiff - docs/latex/wx/dataviewctrl.tex
clarified global and local config files behavior
[wxWidgets.git] / docs / latex / wx / dataviewctrl.tex
index 5b357d31ca51f58b2d48a64cbc08dba49e971990..cf373d73cf4d622f0ce6565ee5b1dd32b3af547a 100644 (file)
@@ -2,11 +2,13 @@
 \section{\class{wxDataViewCtrl}}\label{wxdataviewctrl}
 
 This class and its documentation are work in progress and
 \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
 
 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
 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}.
 
 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}
 
 
 \wxheading{Window styles}
 
@@ -57,6 +60,24 @@ macros to direct input to member functions that take a
 
 \end{twocollist}
 
 
 \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}
 
 
 \wxheading{Derived from}
@@ -89,7 +110,7 @@ Destructor.
 Add a \helpref{wxDataViewColumn}{wxdataviewcolumn} to the control. Note
 that there is a number of short cut methods which implicitly create
 a \helpref{wxDataViewColumn}{wxdataviewcolumn} and a 
 Add a \helpref{wxDataViewColumn}{wxdataviewcolumn} to the control. Note
 that there is a number of short cut methods which implicitly create
 a \helpref{wxDataViewColumn}{wxdataviewcolumn} and a 
-\helpref{wxDataViewRenderer}{wxataviewrenderer} for it (see below).
+\helpref{wxDataViewRenderer}{wxdataviewrenderer} for it (see below).
 
 
 \membersection{wxDataViewCtrl::AppendBitmapColumn}\label{wxdataviewctrlappendbitmapcolumn}
 
 
 \membersection{wxDataViewCtrl::AppendBitmapColumn}\label{wxdataviewctrlappendbitmapcolumn}
@@ -177,9 +198,9 @@ Returns pointer to the column.
 Returns pointer to the data model associated with the
 control (if any).
 
 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.
 
 
 Returns the number of columns.