.. currentmodule:: qte

.. _modelview:

Model/View framework
====================

PySide, through Qt, has an extensive and intricate model/view framework.
This package provides a simpler interface to this through a single
model class, `DataModel` and a single view class `DataView` which are
built on top of `!QAbstractTableModel` and `!QTableView` respectively
but which support tabular data structures.  A `HideProxyMixin` class can be
used as a mixin for proxy models to automatically map unrecognised
attribute lookups to source models.  Two new proxy models,
`SortFilterProxyModel` and `AppendProxyModel` use this mixin.


Models
------

 *  `DataModel`
 *  `CheckFilterModel`


Proxy Models
------------

A new mechanism is provided to hide additional proxy layers between the
view and the source model by use of a `HideProxyMixin` mixin class.  Two
new proxy classes are also available: `AppendProxyModel` and
`SortFilterProxyModel`.

 *  `HideProxyMixin`
 *  `AppendProxyModel`
 *  `SortFilterProxyModel`


Delegates
---------

The basic delegate is `TypedDelegate`, which intelligently manages several
data types, including `datetime` and `SelectList` values.  Delegates for
specific types are subclassed from this, and may be used explicitly instead
for better control.

 *  `TypedDelegate`
 *  `DateTimeDelegate`
 *  `FloatDelegate`
 *  `ListDelegate`


Views
-----

*  `DataView`