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