用QtContact 实现MeeGo通讯录（二）

在用QtContact 实现MeeGo通讯录（一）中我们了解了QtContact基本数据类型和API，以及数据存储和调用的方法，在本篇中，将给出一个详细的例子，来实现上篇中的方法。
本例子代码来源于Meego-app-contacts 项目，详细请浏览该项目：


http://meego.gitorious.org/meego-ux/meego-app-contacts


1、指定数据库
QContactManager class 提供了一个接口，让应用程序与特定的backend进行交互。QContactManager默认指定的backend为EDS，建议使用MeeGo官方的release，已经预装了EDS即相关依赖环境。只需要下面的一行代码就可以创建一个指定backend的接口。
QContactManager *m_manager;


2、填充数据
The QContactDetail class represents a single, complete detail about a contact. 基本数据都可以通过QContactDetail的相关继承函数来填充，如：
QContactAddress adr = curr.detail(QContactAddress::DefinitionName);
adr.setStreet(m_addrEdit->text());
curr.saveDetail(&adr);


3、查找数据
The QContactFilter class is used to select contacts made available through a QContactManager. QContactFilter支持以下类型的查找：
QContactFilter::InvalidFilter
QContactFilter::ContactDetailFilter
QContactFilter::ContactDetailRangeFilter
QContactFilter::ChangeLogFilter
QContactFilter::ActionFilter
QContactFilter::RelationshipFilter
QContactFilter::IntersectionFilter
QContactFilter::UnionFilter
QContactFilter::LocalIdFilter
QContactFilter::DefaultFilter


4.显示数据


4.1.建立Model


用QAbstractListModel建立数据模型
//people.h
class PeopleModel: public QAbstractListModel
{
Q_OBJECT
Q_ENUMS(PeopleRoles)
Q_ENUMS(FilterRoles)
public:
PeopleModel(QObject *parent = 0);
virtual ~PeopleModel();
enum FilterRoles{
AllFilter = 0,
FavoritesFilter,
OnlineFilter,
ContactFilter
};
enum PeopleRoles{
ContactRole = Qt::UserRole + 500,
FirstNameRole, //533
FirstNameProRole,
LastNameRole,
LastNameProRole,
CompanyNameRole,
FavoriteRole,
UuidRole,
PresenceRole,
AvatarRole,
ThumbnailRole,
IsSelfRole,
BirthdayRole,
OnlineAccountUriRole,
OnlineServiceProviderRole,
EmailAddressRole,
EmailContextRole,
PhoneNumberRole,
PhoneContextRole,
AddressRole,
AddressStreetRole,
AddressLocaleRole,
AddressRegionRole,
AddressCountryRole,
AddressPostcodeRole,
AddressContextRole,
WebUrlRole,
WebContextRole,
NotesRole,
FirstCharacterRole
};
//From QAbstractListModel
Q_INVOKABLE virtual int rowCount(const QModelIndex& parent= QModelIndex()) const;
virtual int columnCount(const QModelIndex& parent) const;
virtual QVariant data(const QModelIndex&, int) const;
void queueContactSave(QContact contact);
void removeContact(QContactLocalId contactId);
//QML API
Q_INVOKABLE QVariant data(const int row, int role) const;
Q_INVOKABLE bool createPersonModel(QString avatarUrl, QString thumbUrl, QString firstName, QString firstPro,
QString lastName, QString lastPro,
QString companyname, QStringList phonenumbers, QStringList phonecontexts,
bool favorite, QStringList accounturis, QStringList serviceproviders,
QStringList emailaddys, QStringList emailcontexts, QStringList street,
QStringList city, QStringList state, QStringList zip, QStringList country,
QStringList addresscontexts, QStringList urllinks, QStringList urlcontexts,
QDate birthday, QString notetext);
Q_INVOKABLE void deletePerson(const QString& uuid);
Q_INVOKABLE void editPersonModel(QString contactId, QString avatarUrl, QString firstName, QString firstPro,
QString lastName, QString lastPro, QString companyname,
QStringList phonenumbers, QStringList phonecontexts, bool favorite,
QStringList accounturis, QStringList serviceproviders, QStringList emailaddys,
QStringList emailcontexts, QStringList street, QStringList city, QStringList state,
QStringList zip, QStringList country, QStringList addresscontexts,
QStringList urllinks, QStringList urlcontexts, QDate birthday, QString notetext);
Q_INVOKABLE QMap availableAccounts() const;
Q_INVOKABLE QStringList availableContacts(QString accountId) const;
Q_INVOKABLE void launch (QString cmd) {
QProcess::startDetached (cmd);
}
Q_INVOKABLE void exportContact(QString uuid, QString filename);
Q_INVOKABLE void sort(int flags);
Q_INVOKABLE void setCurrentUuid(const QString& uuid);
QString currentUuid();
Q_INVOKABLE void toggleFavorite(const QString& uuid);
bool isSelfContact(const QContactLocalId id) const;
bool isSelfContact(const QUuid id) const;
Q_INVOKABLE void setSorting(int role);
Q_INVOKABLE void setFilter(int role, bool dataResetNeeded = true);
Q_INVOKABLE int getSortingRole();
Q_INVOKABLE void searchContacts(const QString text);
Q_INVOKABLE void clearSearch();
Q_INVOKABLE void fetchOnlineOnly(const QVariantList &stringids);
protected:
void fixIndexMap();
void addContacts(const QList contactsList, int size);
private slots:
void onSaveStateChanged(QContactAbstractRequest::State requestState);
void onRemoveStateChanged(QContactAbstractRequest::State requestState);
void onDataResetFetchChanged(QContactAbstractRequest::State requestState);
void onAddedFetchChanged(QContactAbstractRequest::State requestState);
void onChangedFetchChanged(QContactAbstractRequest::State requestState);
void onMeFetchRequestStateChanged(QContactAbstractRequest::State requestState);
void contactsAdded(const QList& contactIds);
void contactsChanged(const QList& contactIds);
void contactsRemoved(const QList& contactIds);
void dataReset();
void savePendingContacts();
void createMeCard();
void vCardFinished(QVersitWriter::State state);
private:
PeopleModelPriv *priv;
Q_DISABLE_COPY(PeopleModel);
};


People.cpp
实现people.h中相关函数。


4.2.实现View
可以使用Contacts QML Plugin中的ListView 来显示。
property PeopleModel dataModel: contactModel
ListView {
id: cardListView
anchors.top: groupedViewPortrait.top
anchors.right: groupedViewPortrait.right
anchors.left: groupedViewPortrait.left
height: groupedViewPortrait.height
width: groupedViewPortrait.width
snapMode: ListView.SnapToItem
highlightFollowsCurrentItem: false
focus: true
keyNavigationWraps: false
clip: true
model: sortModel
opacity: 0


delegate: ContactCardPortrait
{
id: card
dataPeople: dataModel
sortPeople: proxyModel
onClicked:
{
cardListView.currentIndex = index;
window.currentContactIndex = index;


//When querying the DataModel, use the index of the contact in the
//not the index of the contact in the ProxyModel
var srcIndex = sortModel.getSourceRow(index);
window.currentContactId = dataPeople.data(srcIndex, PeopleModel.UuidRole);
window.addPage(myAppDetails);
}
onPressAndHold: {
cardListView.currentIndex = index;
window.currentContactIndex = index;
window.currentContactId = uuid;
window.currentContactName = name;
groupedViewPortrait.pressAndHold(mouseX, mouseY);
}
Binding{target: cardListView; property: "height"; value: ((cardListView.count > 1) ? groupedViewPortrait.height : cardListView.childrenRect.height)}
Binding{target: cardListView; property: "interactive"; value: ((cardListView.count > 1) ? true : false)}
}


section.property: "firstcharacter"
section.criteria: ViewSection.FirstCharacter
section.delegate: HeaderPortrait{width: cardListView.width;}
}


基本数据类型就介绍到此，下一篇我们将深入探讨如何保存社交网络和及时通讯相关的数据。

相关链接：用QtContact 实现MeeGo通讯录（一）

摘自英特尔软件网络：

http://g.csdn.net/5194789