就业培训     下载中心     Wiki     联络 登录   注册
  1. 首页
  2. Qt 4.8.7
  3. Outlook 范例 (ActiveQt)

Outlook 范例 (ActiveQt)

范例工程文件看起来像这样： 

TEMPLATE = app
TARGET   = qutlook
CONFIG  += qaxcontainer
TYPELIBS = $$system(dumpcpp -getfile {00062FFF-0000-0000-C000-000000000046})
isEmpty(TYPELIBS) {
    message("Microsoft Outlook type library not found!")
    REQUIRES += Outlook
} else {
    HEADERS  = addressview.h
    SOURCES  = addressview.cpp main.cpp
}

工程文件使用 dumpcpp 工具将 MS Outlook 类型库添加到工程。若这失败，那么生成的 makefile 将仅仅打印错误消息，否则构建步骤现在将运行 dumpcpp 工具在类型库，并生成头和 cpp 文件 (在这种情况下， msoutl.h and msoutl.cpp ) 声明并实现易于使用的 Outlook 对象 API。 

class AddressView : public QWidget
{
    Q_OBJECT
public:
    AddressView(QWidget *parent = 0);
protected slots:
    void addEntry();
    void changeEntry();
    void itemSelected(const QModelIndex &index);
    void updateOutlook();
protected:
    AddressBookModel *model;
    QTreeView *treeView;
    QPushButton *add, *change;
    QLineEdit *iFirstName, *iLastName, *iAddress, *iEMail;
};

AddressView 类是 QWidget 子类对于用户界面。 QTreeView 小部件将显示 Outlook 联络文件夹的内容如提供通过 model . 

#include "addressview.h"
#include "msoutl.h"
#include <QtGui>
class AddressBookModel : public QAbstractListModel
{
public:
    AddressBookModel(AddressView *parent);
    ~AddressBookModel();
    int rowCount(const QModelIndex &parent = QModelIndex()) const;
    int columnCount(const QModelIndex &parent) const;
    QVariant headerData(int section, Qt::Orientation orientation, int role) const;
    QVariant data(const QModelIndex &index, int role) const;
    void changeItem(const QModelIndex &index, const QString &firstName, const QString &lastName, const QString &address, const QString &email);
    void addItem(const QString &firstName, const QString &lastName, const QString &address, const QString &email);
    void update();
private:
    Outlook::Application outlook;
    Outlook::Items * contactItems;
    mutable QHash<QModelIndex, QStringList> cache;
};

AddressBookModel 类是 QAbstractListModel 子类直接与 Outlook 通信，使用 QHash 为缓存。 

AddressBookModel::AddressBookModel(AddressView *parent)
: QAbstractListModel(parent)
{
    if (!outlook.isNull()) {
        Outlook::NameSpace session(outlook.Session());
        session.Logon();
        Outlook::MAPIFolder *folder = session.GetDefaultFolder(Outlook::olFolderContacts);
        contactItems = new Outlook::Items(folder->Items());
        connect(contactItems, SIGNAL(ItemAdd(IDispatch*)), parent, SLOT(updateOutlook()));
        connect(contactItems, SIGNAL(ItemChange(IDispatch*)), parent, SLOT(updateOutlook()));
        connect(contactItems, SIGNAL(ItemRemove()), parent, SLOT(updateOutlook()));
        delete folder;
    }
}

构造函数初始化 Outlook。连接 Outlook 提供的内容即将改变的各种通知信号到 updateOutlook() 槽。 

AddressBookModel::~AddressBookModel()
{
    delete contactItems;
    if (!outlook.isNull())
        Outlook::NameSpace(outlook.Session()).Logoff();
}

析构函数注销会话。 

int AddressBookModel::rowCount(const QModelIndex &) const
{
    return contactItems ? contactItems->Count() : 0;
}
int AddressBookModel::columnCount(const QModelIndex &parent) const
{
    return 4;
}

The rowCount() 实现返回由 Outlook 报告的条目数。 columnCount and headerData 被实现为在树视图中展示 4 列。 

QVariant AddressBookModel::headerData(int section, Qt::Orientation orientation, int role) const
{
    if (role != Qt::DisplayRole)
        return QVariant();
    switch (section) {
    case 0:
        return tr("First Name");
    case 1:
        return tr("Last Name");
    case 2:
        return tr("Address");
    case 3:
        return tr("Email");
    default:
        break;
    }
    return QVariant();
}

The headerData() 实现返回硬编码字符串。 

QVariant AddressBookModel::data(const QModelIndex &index, int role) const
{
    if (!index.isValid() || role != Qt::DisplayRole)
        return QVariant();
    QStringList data;
    if (cache.contains(index)) {
        data = cache.value(index);
    } else {
        Outlook::ContactItem contact(contactItems->Item(index.row() + 1));
        data << contact.FirstName() << contact.LastName() << contact.HomeAddress() << contact.Email1Address();
        cache.insert(index, data);
    }
    if (index.column() < data.count())
        return data.at(index.column());
    return QVariant();
}

The data() 实现是模型核心。若请求数据在缓存中，使用缓存值，否则从 Outlook 获取数据。 

void AddressBookModel::changeItem(const QModelIndex &index, const QString &firstName, const QString &lastName, const QString &address, const QString &email)
{
    Outlook::ContactItem item(contactItems->Item(index.row() + 1));
    item.SetFirstName(firstName);
    item.SetLastName(lastName);
    item.SetHomeAddress(address);
    item.SetEmail1Address(email);
    item.Save();
    cache.take(index);
}

The changeItem() 槽被调用当用户使用用户界面改变当前条目时。Outlook 项的访问是使用 Outlook API，而修改是使用特性 setter。最后，项被保存到 Outlook，并从缓存移除它。注意，模型将不发射数据视图改变信号，因为 Outlook 自己会发射信号。 

void AddressBookModel::addItem(const QString &firstName, const QString &lastName, const QString &address, const QString &email)
{
    Outlook::ContactItem item(outlook.CreateItem(Outlook::olContactItem));
    if (!item.isNull()) {
        item.SetFirstName(firstName);
        item.SetLastName(lastName);
        item.SetHomeAddress(address);
        item.SetEmail1Address(email);
        item.Save();
    }
}

The addItem() 槽调用 Outlook 的 CreateItem 方法创建新的联络项，并将新项的特性设为用户输入值再保存项。 

void AddressBookModel::update()
{
    cache.clear();
    emit reset();
}

The update() 槽清零缓存，并发射 reset () 信号通知视图数据即将改变要求重新绘制内容。 

AddressView::AddressView(QWidget *parent)
: QWidget(parent)
{
    QGridLayout *mainGrid = new QGridLayout(this);
    QLabel *liFirstName = new QLabel("First &Name", this);
    liFirstName->resize(liFirstName->sizeHint());
    mainGrid->addWidget(liFirstName, 0, 0);
    QLabel *liLastName = new QLabel("&Last Name", this);
    liLastName->resize(liLastName->sizeHint());
    mainGrid->addWidget(liLastName, 0, 1);
    QLabel *liAddress = new QLabel("Add&ress", this);
    liAddress->resize(liAddress->sizeHint());
    mainGrid->addWidget(liAddress, 0, 2);
    QLabel *liEMail = new QLabel("&E-Mail", this);
    liEMail->resize(liEMail->sizeHint());
    mainGrid->addWidget(liEMail, 0, 3);
    add = new QPushButton("A&dd", this);
    add->resize(add->sizeHint());
    mainGrid->addWidget(add, 0, 4);
    connect(add, SIGNAL(clicked()), this, SLOT(addEntry()));
    iFirstName = new QLineEdit(this);
    iFirstName->resize(iFirstName->sizeHint());
    mainGrid->addWidget(iFirstName, 1, 0);
    liFirstName->setBuddy(iFirstName);
    iLastName = new QLineEdit(this);
    iLastName->resize(iLastName->sizeHint());
    mainGrid->addWidget(iLastName, 1, 1);
    liLastName->setBuddy(iLastName);
    iAddress = new QLineEdit(this);
    iAddress->resize(iAddress->sizeHint());
    mainGrid->addWidget(iAddress, 1, 2);
    liAddress->setBuddy(iAddress);
    iEMail = new QLineEdit(this);
    iEMail->resize(iEMail->sizeHint());
    mainGrid->addWidget(iEMail, 1, 3);
    liEMail->setBuddy(iEMail);
    change = new QPushButton("&Change", this);
    change->resize(change->sizeHint());
    mainGrid->addWidget(change, 1, 4);
    connect(change, SIGNAL(clicked()), this, SLOT(changeEntry()));
    treeView = new QTreeView(this);
    treeView->setSelectionMode(QTreeView::SingleSelection);
    treeView->setRootIsDecorated(false);
    model = new AddressBookModel(this);
    treeView->setModel(model);
    connect(treeView->selectionModel(), SIGNAL(currentChanged(QModelIndex,QModelIndex)), this, SLOT(itemSelected(QModelIndex)));
    mainGrid->addWidget(treeView, 2, 0, 1, 5);
}
void AddressView::updateOutlook()
{
    model->update();
}
void AddressView::addEntry()
{
    if (!iFirstName->text().isEmpty() || !iLastName->text().isEmpty() ||
         !iAddress->text().isEmpty() || !iEMail->text().isEmpty()) {
        model->addItem(iFirstName->text(), iFirstName->text(), iAddress->text(), iEMail->text());
    }
    iFirstName->setText("");
    iLastName->setText("");
    iAddress->setText("");
    iEMail->setText("");
}
void AddressView::changeEntry()
{
    QModelIndex current = treeView->currentIndex();
    if (current.isValid())
        model->changeItem(current, iFirstName->text(), iLastName->text(), iAddress->text(), iEMail->text());
}
void AddressView::itemSelected(const QModelIndex &index)
{
    if (!index.isValid())
        return;
    QAbstractItemModel *model = treeView->model();
    iFirstName->setText(model->data(model->index(index.row(), 0)).toString());
    iLastName->setText(model->data(model->index(index.row(), 1)).toString());
    iAddress->setText(model->data(model->index(index.row(), 2)).toString());
    iEMail->setText(model->data(model->index(index.row(), 3)).toString());
}

文件的其余部分仅使用 Qt API 实现用户界面，即：不直接与 Outlook 进行通信。 

#include "addressview.h"
#include <QApplication>
int main(int argc, char ** argv)
{
    QApplication a(argc, argv);
    AddressView view;
    view.setWindowTitle("Qt Example - Looking at Outlook");
    view.show();
    return a.exec();
}

The main() 入口点函数最后实例化用户界面并进入事件循环。

要构建范例必须先构建 QAxContainer 库。然后运行 make 工具在 examples/activeqt/qutlook 和运行结果 qutlook.exe .

文件：