Пример "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.
|
Попытка перевода Qt документации. Если есть желание присоединиться, или если есть замечания или пожелания, то заходите на форум: Перевод Qt документации на русский язык... Люди внесшие вклад в перевод: Команда переводчиков |