Пример "Qutlook" (ActiveQt)
Файлы:
Пример "Qutlook" демонстрирует использование ActiveQt для автоматизации Outlook. Пример использует инструмент dumpcpp для генерации пространства имен C++ для библиотеки типов, описывающей объектную модель Outlook.
Файл проекта для примера выглядит примерно так:
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 в проект. Если это завершится неудачно, тогда генерируемый make-файл только напечатает сообщение об ошибке, в противном случае этап сборки будет теперь запускать инструмент dumpcpp на библиотеке типов и генерировать заголовочный файл и файл cpp (в данном случае, msoutl.h и msoutl.cpp), что объявляет и реализует легкий в использовании API к объектам Outlook.
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 будет отображать содержимое папки Контакт (Contact) 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() slot.
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;
}
Реализация rowCount() возвращает несколько записей как сообщал Outlook. columnCount и headerData реализованы для показа четырех столбцов в представлении дерева.
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();
}
Реализация 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();
}
Реализация 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);
}
Слот changeItem() вызывается когда пользователь изменяет текущую запись используя пользовательский интерфейс. Элемент Outlook доступен с использованием Outlook API, а изменяется с использованием функций-сеттеров свойств. В конечном счёте элемент сохраняется в 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();
}
}
Слот addItem() вызывает метод Outlook, CreateItem, для создания нового элемента контакта, устанавливает свойства нового элемента в значения введённые пользователем и сохраняет элемент.
void AddressBookModel::update()
{
cache.clear();
emit reset();
}
Слот 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();
}
Точка входа функции main() в конечном счёте создаёт объект пользовательского интерфейса и входит в цикл обработки событий.
Чтобы собрать пример вы должны сначала собрать библиотеку QAxContainer. Затем запустите ваш make-инструмент в каталоге examples/activeqt/qutlook и запустите получившийся в результате qutlook.exe.
Copyright © 2009 Nokia Corporation and/or its subsidiary(-ies) |
Торговые марки |
Qt 4.5.3 |
|