• Skip to content
  • Skip to link menu
  • KDE API Reference
  • kdepimlibs-4.9.1 API Reference
  • KDE Home
  • Contact Us
 

akonadi

  • Akonadi
  • ContactsTreeModel
Public Types | Public Member Functions
Akonadi::ContactsTreeModel Class Reference

#include <contactstreemodel.h>

Inheritance diagram for Akonadi::ContactsTreeModel:
Inheritance graph
[legend]

List of all members.

Public Types

enum  Column {
  FullName, FamilyName, GivenName, Birthday,
  HomeAddress, BusinessAddress, PhoneNumbers, PreferredEmail,
  AllEmails, Organization, Role, Homepage,
  Note
}
typedef QList< Column > Columns
enum  Roles { DateRole = EntityTreeModel::UserRole + 1, UserRole = DateRole + 42 }
- Public Types inherited from Akonadi::EntityTreeModel
enum  CollectionFetchStrategy { FetchNoCollections, FetchFirstLevelChildCollections, FetchCollectionsRecursive, InvisibleCollectionFetch }
enum  FetchState { IdleState, FetchingState }
enum  HeaderGroup {
  EntityTreeHeaders, CollectionTreeHeaders, ItemListHeaders, UserHeaders = 10,
  EndHeaderGroup = 32
}
enum  ItemPopulationStrategy { NoItemPopulation, ImmediatePopulation, LazyPopulation }

Public Member Functions

 ContactsTreeModel (ChangeRecorder *monitor, QObject *parent=0)
virtual ~ContactsTreeModel ()
Columns columns () const
void setColumns (const Columns &columns)
- Public Member Functions inherited from Akonadi::EntityTreeModel
 EntityTreeModel (ChangeRecorder *monitor, QObject *parent=0)
virtual ~EntityTreeModel ()
virtual bool canFetchMore (const QModelIndex &parent) const
CollectionFetchStrategy collectionFetchStrategy () const
virtual int columnCount (const QModelIndex &parent=QModelIndex()) const
virtual QVariant data (const QModelIndex &index, int role=Qt::DisplayRole) const
virtual bool dropMimeData (const QMimeData *data, Qt::DropAction action, int row, int column, const QModelIndex &parent)
virtual void fetchMore (const QModelIndex &parent)
virtual Qt::ItemFlags flags (const QModelIndex &index) const
virtual bool hasChildren (const QModelIndex &parent=QModelIndex()) const
virtual QVariant headerData (int section, Qt::Orientation orientation, int role=Qt::DisplayRole) const
bool includeRootCollection () const
bool includeUnsubscribed () const
virtual QModelIndex index (int row, int column, const QModelIndex &parent=QModelIndex()) const
ItemPopulationStrategy itemPopulationStrategy () const
virtual QModelIndexList match (const QModelIndex &start, int role, const QVariant &value, int hits=1, Qt::MatchFlags flags=Qt::MatchFlags(Qt::MatchStartsWith|Qt::MatchWrap)) const
virtual QMimeData * mimeData (const QModelIndexList &indexes) const
virtual QStringList mimeTypes () const
virtual QModelIndex parent (const QModelIndex &index) const
QString rootCollectionDisplayName () const
virtual int rowCount (const QModelIndex &parent=QModelIndex()) const
void setCollectionFetchStrategy (CollectionFetchStrategy strategy)
virtual bool setData (const QModelIndex &index, const QVariant &value, int role=Qt::EditRole)
void setIncludeRootCollection (bool include)
void setIncludeUnsubscribed (bool show)
void setItemPopulationStrategy (ItemPopulationStrategy strategy)
void setRootCollectionDisplayName (const QString &name)
void setShowSystemEntities (bool show)
virtual Qt::DropActions supportedDropActions () const
bool systemEntitiesShown () const

Additional Inherited Members

- Static Public Member Functions inherited from Akonadi::EntityTreeModel
static QModelIndexList modelIndexesForItem (const QAbstractItemModel *model, const Item &item)
static QModelIndex modelIndexForCollection (const QAbstractItemModel *model, const Collection &collection)
- Protected Member Functions inherited from Akonadi::EntityTreeModel
void clearAndReset ()
virtual int entityColumnCount (HeaderGroup headerGroup) const
virtual QVariant entityData (const Item &item, int column, int role=Qt::DisplayRole) const
virtual QVariant entityData (const Collection &collection, int column, int role=Qt::DisplayRole) const
virtual QVariant entityHeaderData (int section, Qt::Orientation orientation, int role, HeaderGroup headerGroup) const
virtual bool entityMatch (const Item &item, const QVariant &value, Qt::MatchFlags flags) const
virtual bool entityMatch (const Collection &collection, const QVariant &value, Qt::MatchFlags flags) const

Detailed Description

A model for contacts and contact groups as available in Akonadi.

This class provides a model for displaying the contacts and contact groups which are available from Akonadi.

Example:

// use a separated session for this model
Akonadi::Session *session = new Akonadi::Session( "MySession" );
Akonadi::ItemFetchScope scope;
// fetch all content of the contacts, including images
scope.fetchFullPayload( true );
// fetch the EntityDisplayAttribute, which contains custom names and icons
scope.fetchAttribute<Akonadi::EntityDisplayAttribute>();
Akonadi::ChangeRecorder *changeRecorder = new Akonadi::ChangeRecorder;
changeRecorder->setSession( session );
// include fetching the collection tree
changeRecorder->fetchCollection( true );
// set the fetch scope that shall be used
changeRecorder->setItemFetchScope( scope );
// monitor all collections below the root collection for changes
changeRecorder->setCollectionMonitored( Akonadi::Collection::root() );
// list only contacts and contact groups
changeRecorder->setMimeTypeMonitored( KABC::Addressee::mimeType(), true );
changeRecorder->setMimeTypeMonitored( KABC::ContactGroup::mimeType(), true );
Akonadi::ContactsTreeModel *model = new Akonadi::ContactsTreeModel( changeRecorder );
Akonadi::ContactsTreeModel::Columns columns;
columns << Akonadi::ContactsTreeModel::FullName;
columns << Akonadi::ContactsTreeModel::AllEmails;
model->setColumns( columns );
Akonadi::EntityTreeView *view = new Akonadi::EntityTreeView;
view->setModel( model );
Author:
Tobias Koenig tokoe.nosp@m.@kde.nosp@m..org
Since:
4.5

Definition at line 78 of file contactstreemodel.h.


Member Typedef Documentation

typedef QList<Column> Akonadi::ContactsTreeModel::Columns

Describes a list of columns of the contacts tree model.

Definition at line 157 of file contactstreemodel.h.


Member Enumeration Documentation

enum Akonadi::ContactsTreeModel::Column

Describes the columns that can be shown by the model.

Enumerator:
FullName 

Shows the formatted name or, if empty, the assembled name.

FamilyName 

Shows the family name.

GivenName 

Shows the given name.

Birthday 

Shows the birthday.

HomeAddress 

Shows the formatted home address.

BusinessAddress 

Shows the formatted business address.

PhoneNumbers 

Shows the phone numbers.

PreferredEmail 

Shows the preferred email address.

AllEmails 

Shows all email address.

Organization 

Shows organization name.

Role 

Shows the role of a contact.

Homepage 

Shows homepage url.

Note 

Shows the note.

Definition at line 86 of file contactstreemodel.h.

enum Akonadi::ContactsTreeModel::Roles

Describes the role for contacts and contact groups.

Enumerator:
DateRole 

The QDate object for the current index.

UserRole 

First role for user extensions.

Reimplemented from Akonadi::EntityTreeModel.

Definition at line 162 of file contactstreemodel.h.


Constructor & Destructor Documentation

Akonadi::ContactsTreeModel::ContactsTreeModel ( ChangeRecorder *  monitor,
QObject *  parent = 0 
)
explicit

Creates a new contacts tree model.

Parameters:
monitorThe ChangeRecorder whose entities should be represented in the model.
parentThe parent object.
virtual Akonadi::ContactsTreeModel::~ContactsTreeModel ( )
virtual

Destroys the contacts tree model.


Member Function Documentation

Columns Akonadi::ContactsTreeModel::columns ( ) const

Returns the columns that the model currently shows.

void Akonadi::ContactsTreeModel::setColumns ( const Columns &  columns)

Sets the columns that the model should show.


The documentation for this class was generated from the following file:
  • contactstreemodel.h
This file is part of the KDE documentation.
Documentation copyright © 1996-2012 The KDE developers.
Generated on Mon Sep 24 2012 09:06:30 by doxygen 1.8.1.1 written by Dimitri van Heesch, © 1997-2006

KDE's Doxygen guidelines are available online.

akonadi

Skip menu "akonadi"
  • Main Page
  • Namespace List
  • Namespace Members
  • Alphabetical List
  • Class List
  • Class Hierarchy
  • Class Members
  • File List
  • Modules
  • Related Pages

kdepimlibs-4.9.1 API Reference

Skip menu "kdepimlibs-4.9.1 API Reference"
  • akonadi
  •   contact
  •   kmime
  • kabc
  • kalarmcal
  • kblog
  • kcal
  • kcalcore
  • kcalutils
  • kholidays
  • kimap
  • kioslave
  •   imap4
  •   mbox
  •   nntp
  • kldap
  • kmbox
  • kmime
  • kontactinterface
  • kpimidentities
  • kpimtextedit
  •   richtextbuilders
  • kpimutils
  • kresources
  • ktnef
  • kxmlrpcclient
  • mailtransport
  • microblog
  • qgpgme
  • syndication
  •   atom
  •   rdf
  •   rss2
Report problems with this website to our bug tracking system.
Contact the specific authors with questions and comments about the page contents.

KDE® and the K Desktop Environment® logo are registered trademarks of KDE e.V. | Legal