QSmoothContactListView Class Reference
[QtMessagingModule, QtPimModule, QtTelephonyModule, QtUiModule]

Detailed Description

The QSmoothContactListView class provides a list view widget for use with QContactModel.

The convenience functions provided by QSmoothContactListView include functions for interpreting the view's model, delegate and current item as the corresponding QContactModel, QContactDelegate and QContact objects. In addition, QSmoothContactListView enforces using a QContactModel (or a derivative) as the model.

Upon construction, QSmoothContactListView automatically sets itself to use a QContactDelegate for drawing.

The following image displays a QSmoothContactListView, using the default QContactDelegate to render QContacts from a QContactModel.

The API of this class is a subset of the QContactListView API.

See also QContact, QContactModel, QContactDelegate, and Pim Library.

Member Function Documentation

QSmoothContactListView::QSmoothContactListView ( QWidget * parent = 0 )

Constructs a QSmoothContactListView with the given parent.

This also sets the layout mode to Batched for performance, the resize mode to Adjust, and creates a QContactDelegate to use as the delegate.

QSmoothContactListView::~QSmoothContactListView ()

Destroys the QSmoothContactListView.

QContactDelegate * QSmoothContactListView::contactDelegate () const

Returns the QContactDelegate set for the view. During construction, QSmoothContactListView will automatically create a QContactDelegate to use as the delegate, but this can be overridden with a different delegate derived from QContactDelegate if necessary.

QContactModel * QSmoothContactListView::contactModel () const

Returns the QContactModel set for the view.

QContact QSmoothContactListView::currentContact () const

Returns the QContact for the currently selected index.

void QSmoothContactListView::setModel ( QAbstractItemModel * model )

Sets the model for the view to model.

void QSmoothContactListView::setTextEntryProxy ( QTextEntryProxy * proxy )

Sets a QTextEntryProxy for the list view to proxy. This allows the list view to accept text and InputMethod events, which it will pass to proxy. The text of the proxy is used for filtering the list of contacts in the view.

See also textEntryProxy().

QTextEntryProxy * QSmoothContactListView::textEntryProxy () const

Returns the QTextEntryProxy for the list view. If there is no QTextEntryProxy set returns 0.

See also setTextEntryProxy().