Home · All Namespaces · All Classes · Grouped Classes · Modules · Functions

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

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

    #include <QContactListView>

Inherits QListView.

• List of all members, including inherited members

Public Functions

• QContactListView ( QWidget * parent = 0 )
• ~QContactListView ()
• QContactDelegate * contactDelegate () const
• QContactModel * contactModel () const
• QContact currentContact () const
• QList<QUniqueId> selectedContactIds () const
• QList<QContact> selectedContacts () const
• virtual void setModel ( QAbstractItemModel * model )
• void setTextEntryProxy ( QTextEntryProxy * proxy )
• QTextEntryProxy * textEntryProxy () const

• 29 public functions inherited from QListView
• 54 public functions inherited from QAbstractItemView
• 15 public functions inherited from QAbstractScrollArea
• 13 public functions inherited from QFrame
• 206 public functions inherited from QWidget
• 29 public functions inherited from QObject
• 14 public functions inherited from QPaintDevice

Additional Inherited Members

• 13 properties inherited from QListView
• 15 properties inherited from QAbstractItemView
• 2 properties inherited from QAbstractScrollArea
• 6 properties inherited from QFrame
• 57 properties inherited from QWidget
• 1 property inherited from QObject
• 9 public slots inherited from QAbstractItemView
• 19 public slots inherited from QWidget
• 1 public slot inherited from QObject
• 1 signal inherited from QListView
• 6 signals inherited from QAbstractItemView
• 1 signal inherited from QWidget
• 1 signal inherited from QObject
• 1 public type inherited from QObject
• 4 static public members inherited from QWidget
• 4 static public members inherited from QObject
• 2 protected functions inherited from QListView
• 33 protected functions inherited from QAbstractItemView
• 16 protected functions inherited from QAbstractScrollArea
• 38 protected functions inherited from QWidget
• 7 protected functions inherited from QObject
• 1 protected function inherited from QPaintDevice
• 9 protected slots inherited from QAbstractItemView
• 1 protected slot inherited from QAbstractScrollArea
• 1 protected slot inherited from QWidget
• 2 protected variables inherited from QObject
• 1 protected type inherited from QPaintDevice

Detailed Description

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

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

Upon construction, QContactListView automatically sets itself to use a QContactDelegate for drawing, sets Batch layout mode (setLayoutMode()), and sets the resize mode to Adjust (setResizeMode()).

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

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

Member Function Documentation

QContactListView::QContactListView ( QWidget * parent = 0 )

Constructs a QContactListView 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.

QContactListView::~QContactListView ()

Destroys the QContactListView.

QContactDelegate * QContactListView::contactDelegate () const

Returns the QContactDelegate set for the view. During construction, QContactListView 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 * QContactListView::contactModel () const

Returns the QContactModel set for the view.

QContact QContactListView::currentContact () const

Returns the QContact for the currently selected index.

QList<QUniqueId> QContactListView::selectedContactIds () const

Returns the list of ids for contacts selected in the view.

See also selectedContacts().

QList<QContact> QContactListView::selectedContacts () const

Returns the list of complete contacts selected from the view. If a large number of contacts might be selected this function can be expensive, and selectedContactIds() should be used instead.

See also selectedContactIds().

void QContactListView::setModel ( QAbstractItemModel * model )   [virtual]

Sets the model for the view to model.

Reimplemented from QAbstractItemView.

void QContactListView::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 * QContactListView::textEntryProxy () const

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

See also setTextEntryProxy().