Использование ActiveX-компонентов и COM в Qt

Модуль QAxContainer является частью фреймворка ActiveQt. Он предоставляет библиотеку, реализующую подкласс QWidget, QAxWidget, который выступает в качестве контейнера для ActiveX-компонентов, и подкласс QObject, QAxObject, который может использоваться для простого доступа к невизуальным COM-объектам. Скриптовое управление COM-объектами, встроенными с помощью этих классов, возможно через классы QAxScript, QAxScriptManager и QAxScriptEngine, а набор инструментов упрощает программно доступ к COM-объектам.

Модуль состоит из шести классов

1. QAxBase — это абстрактный класс, предоставляющий API для инициализации и доступа к COM-объекту или ActiveX-компоненту.
2. QAxObject предоставляет QObject, который оборачивает COM-объект.
3. QAxWidget — это QWidget, который оборачивает ActiveX-компонент.
4. QAxScriptManager, QAxScript и QAxScriptEngine предоставляют интерфейс к Windows Script Host.

Предоставляются некоторые примеры приложений, которые используют стандартные ActiveX-компоненты для обеспечения функциональности пользовательского интерфейса высокого уровня.

Темы:

Использование библиотеки

Для построения приложений Qt, которые могут размещать COM-объекты и ActiveX-компоненты, свяжите приложение с модулем QAxContainer, добавив

QT += axcontainer

в файл .pro вашего приложения.

Распространение приложений QAxContainer

Библиотека QAxContainer является статической, поэтому при использовании этого модуля нет необходимости перераспределять какие-либо дополнительные файлы. Однако обратите внимание, что двоичные файлы сервера ActiveX, которые вы используете, могут быть не установлены на целевой системе, поэтому вы должны включить их в свой пакет и зарегистрировать во время процесса установки вашего приложения.

Инициализация COM-объектов

Для инициализации COM-объекта используйте API QAxBase::setControl() или передайте имя объекта напрямую в конструктор подкласса QAxBase, который вы используете.

Компонент может быть указан в различных форматах, но самый быстрый и мощный формат — использовать идентификатор класса (CLSID) объекта напрямую. Идентификатор класса может быть дополнен информацией о удаленной машине, на которой должен выполняться объект, и может включать ключ лицензии для лицензированных компонентов.

Типичные сообщения об ошибках

ActiveQt выводит сообщения об ошибках в вывод отладки при обнаружении ошибок во время выполнения. Обычно для просмотра этих сообщений необходимо запустить программу в отладчике (например, в окне вывода отладки Visual Studio).

Запрошенный компонент не может быть инициализирован

Запрошенный в QAxBase::setControl() компонент не установлен в этой системе или недоступен для текущего пользователя.

Для компонента могут потребоваться права администратора или ключ лицензии. Если компонент лицензионный, передайте ключ лицензии в QAxBase::setControl, как описано.

Доступ к API объекта

ActiveQt предоставляет Qt API для COM-объекта и заменяет типы данных COM эквивалентами Qt.

Существует четыре способа вызова API COM-объекта:

• Генерация пространства имен C++
• Вызов по имени
• Через движок скриптов
• Использование нативных COM-интерфейсов

Генерация пространства имен C++

Для генерации пространства имен C++ для библиотеки типов, к которой вы хотите получить доступ, используйте инструмент dumpcpp. Запустите этот инструмент вручную на библиотеке типов, которую вы хотите использовать, или интегрируйте его в систему сборки, добавив библиотеки типов в переменную TYPELIBS в файле .pro вашего приложения:

TYPELIBS = file.tlb

Обратите внимание, что dumpcpp может не предоставить доступ ко всем API в библиотеке типов.

Включите полученный заголовочный файл в свой код для доступа к API объекта через сгенерированные классы C++. Дополнительную информацию см. в примере Qutlook.

Вызов по имени

Используйте QAxBase::dynamicCall() и QAxBase::querySubObject(), а также API QObject::setProperty() и QObject::property() для вызова методов и свойств COM-объекта по их имени. Используйте инструмент dumpdoc для получения документации Qt API для любого COM-объекта и его подобъектов; обратите внимание, что доступны не все API COM-объекта.

Дополнительную информацию см. в примере Media Player.

Вызов функции через движок скриптов

Приложение Qt может разместить любой движок ActiveScript, установленный в системе. Затем движок скриптов может выполнить скриптовый код, который получает доступ к COM-объектам.

Для инициализации движка скриптов используйте QAxScriptManager::addObject() для регистрации COM-объектов, к которым вы хотите получить доступ из скрипта, и QAxScriptManager::load() для загрузки скриптового кода в движок. Затем вызовите скриптовые функции с помощью QAxScriptManager::call() или QAxScript::call().

Какие API COM-объекта доступны через скрипты, зависит от используемого языка скриптов.

Контейнер тестирования ActiveX ActiveX Test Container демонстрирует загрузку скриптовых файлов.

Вызов функции с использованием нативных COM-интерфейсов

Для вызова функций COM-объекта, к которым нельзя получить доступ ни одним из вышеперечисленных методов, можно напрямую запросить COM-интерфейс с помощью QAxBase::queryInterface(). Чтобы получить определение C++ соответствующих классов интерфейсов, используйте директиву #import с библиотекой типов, предоставленной компонентом; см. руководство по вашему компилятору для получения подробностей.

Типичные сообщения об ошибках

ActiveQt выводит сообщения об ошибках в вывод отладки при обнаружении ошибок во время выполнения. Обычно для просмотра этих сообщений необходимо запустить программу в отладчике (например, в окне вывода отладки Visual Studio).

QAxBase::internalInvoke: Нет такого метода

QAxBase::dynamicCall() завершился ошибкой — прототип функции не совпадает ни с одной функцией, доступной в API объекта.

Ошибка вызова члена IDispatch: Не хватает необязательного параметра

QAxBase::dynamicCall() завершился ошибкой — прототип функции был верным, но было предоставлено слишком мало параметров.

Ошибка вызова члена IDispatch: Несоответствие типа в параметре n

QAxBase::dynamicCall() завершился ошибкой — прототип функции был верным, но параметр с индексом n имел неправильный тип и не мог быть преобразован к правильному типу.

QAxScriptManager::call(): Ни один скрипт не предоставляет эту функцию

Вы пытаетесь вызвать функцию, которая предоставляется движком, не предоставляющим интроспекцию (например, ActivePython или ActivePerl). Вам необходимо вызвать функцию непосредственно в соответствующем объекте QAxScript.

См. также Фреймворк ActiveQt.