Инструмент 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();

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

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.