Инструмент dumpcpp (ActiveQt)

Инструмент dumpcpp генерирует пространство имён C++ для библиотеки типов.

Для генерации пространства имён C++ для библиотеки типов вызовите dumpcpp с параметрами командной строки:

dumpcpp можно интегрировать в систему сборки qmake. В файле .pro перечислите библиотеки типов, которые вы хотите использовать, в переменной TYPELIBS:

TEMPLATE = app
TARGET   = qutlook
QT += widgets axcontainer

TYPELIBS = $$system(dumpcpp -getfile {00062FFF-0000-0000-C000-000000000046})

Сгенерированное пространство имён будет объявлять все перечисления, а также один подкласс QAxObject для каждого coclass и interface объявленного в библиотеке типов. coclasses, помеченные атрибутом control, будут обернуты подклассом QAxWidget.

Классы, которые оборачивают создаваемые coclasses (т.е. coclasses, не помеченные как noncreatable), имеют конструктор по умолчанию; это обычно один класс типа Application.

Outlook::Application *outlook = new Outlook::Application;

Все остальные классы могут быть созданы только путем передачи указателя на интерфейс IDispatch конструктору; однако эти классы не должны создаваться явно. Вместо этого используйте соответствующий API уже созданных объектов.

Outlook::_NameSpace *session = outlook->Session();

Все обертки coclasses также имеют один конструктор, принимающий класс обёртки интерфейса для каждого реализованного интерфейса.

Outlook::NameSpace *session = outlook->Session();

Вы должны создать coclasses, чтобы иметь возможность подключиться к сигналам подобъекта. Обратите внимание, что конструктор удаляет объект интерфейса, поэтому следующее действие вызовет ошибку сегментации:

Outlook::_NameSpace *tmp = outlook->Session();
Outlook::NameSpace *session = new Outlook::NameSpace(tmp);
delete tmp; // or any other use of tmp: segfault

Если возвращаемый тип - тип coclass или интерфейс, объявленные в другой библиотеке типов, необходимо включить заголовок пространства имён этой другой библиотеки типов перед включением заголовка пространства имён, которое вы хотите использовать (оба заголовка должны быть сгенерированы с помощью этого инструмента).

По умолчанию методы и свойства, возвращающие подобъекты, будут использовать тип, как в библиотеке типов. Вызывающая сторона функции отвечает за удаление или переродительство возвращённого объекта. Если установлен переключатель -compat, свойства и методы, возвращающие COM-объект, имеют возвращаемый тип IDispatch*, и пространство имён не будет объявлять классы-обертки для интерфейсов.

В этом случае создайте нужный класс-обёртку явно:

Outlook::NameSpace *session = new Outlook::NameSpace(outlook->Session());

Конечно, вы можете использовать возвращенный IDispatch*, в этом случае вам нужно вызвать Release() после завершения работы с интерфейсом.

Все классы в пространстве имён помечены макросом, который позволяет их экспортировать или импортировать из DLL. Для этого объявите макрос, который будет расширяться до __declspec(dllimport/export) перед включением заголовочного файла.

Для построения инструмента необходимо сначала построить библиотеку QAxContainer. Затем запустите вашу утилиту make в tools/dumpcpp.