Простой пример создания ActiveX-control на Qt

Введение

Мне была поставлена задача разработать некий ActiveX-control. Так как основным языком программирования для разработки у нас используется C++, то C# не рассматривался. Я решил выбрать Qt, так как он мне интересен.

Создание ActiveX объектов на Qt достаточно простой процесс, в примерах к QtCreator есть несколько вариантов, показывающих как можно использовать ActiveQt (например этот).

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

Сразу обращу внимание, что не описываю всю технологию ActiveQt, подробную информацию можно получить в документации Qt Assistant и в интернете (например здесь), это пример и пара интересных на мой взгляд моментов.

Начало

Итак, для начала устанавливаем QtSDK (я выбрал коммерческую версию в связке с MS VisualStudio 2010).

Создаем пустой проект. В качестве примера создадим ActiveX-control с цифровыми часами (возьмем пример отсюда).

Добавляем в наш проект класс цифровых часов.
Добавляем файл main.cpp, в нем создадим класс, унаследованный от QAxFactory. Этот класс реализовывает фабрику, предоставляющую информацию об элементах управления и создает их по запросу.

#include <QAxFactory>
#include "clock.h" // заголовочный файл класса цифровых часов

class ActiveQtFactory : public QAxFactory
{
public:
    ActiveQtFactory( const QUuid &lib, const QUuid &app )
    : QAxFactory( lib, app )

    {}
    // список импортируемых классов
    QStringList featureList() const
    {
        QStringList list;
       // если классов будет несколько, то нужно будет добавить в список имя каждого
       //  в данном пример только один "Clock"
        list << "Clock";
        return list;
    }
    // создание объекта экспортируемого класса
    QObject *createObject(const QString &key)
    {
        if ( key == "Clock" )
            return new Clock();
       // аналогично для каждого класса
        return 0;
    }
    // получение мета-информации о классе
    const QMetaObject *metaObject( const QString &key ) const
    {
        if ( key == "Clock" )
            return &Clock::staticMetaObject;
       // аналогично для каждого класса
        return 0;
    }
};

// экспорт фабрики
QAXFACTORY_EXPORT( ActiveQtFactory, "{c1de5776-a143-4884-89fc-81a06d04e87d}", "{11403913-dc94-484a-af5a-521f0e93d2ee}" )

Если захотим в библиотеку добавить другие классы, то нужно подключить их заголовочные файлы и добавить описание в класс ActiveQtFactory

Теперь доработаем класс Clock для экспортирования его метаданных:
В заголовок добавим макрос для динамической библиотеки

// ...........
#include <qglobal.h>

#if defined(Clock_LIBRARY)
#  define Clock_LIBRARY Q_DECL_EXPORT
#else
#  define Clock_LIBRARY Q_DECL_IMPORT
#endif

class Clock_LIBRARY Clock : public QLCDNumber
{
// ...........

Добавим информацию о классе

   
    // ..............
    Q_OBJECT
    Q_CLASSINFO("ClassID", "{1edd41d0-e01f-445d-9b4e-78c99ab93acf}")
    Q_CLASSINFO("InterfaceID", "{8adccb5c-567e-42f6-8b81-f6634409fb1a}")
    Q_CLASSINFO("EventsID", "{f0a4474f-8c0c-4cdf-985d-8379b26bdd19}")
    // ..............

Для каждого класса необходимо указывать свои ClassID, InterfaceID, EventsID.

Заключительный момент, скорректируем файл проекта

TEMPLATE = lib
CONFIG	+= qt qaxserver dll
contains(CONFIG, static):DEFINES += QT_NODLL

SOURCES	 = main.cpp 
   clock.cpp

HEADERS +=     
   clock.h

DEF_FILE = qaxserver.def
DEFINES += clock_LIBRARY
VERSION = 0.0.0.1

# Подключаем заголовочные файлы библиотеки
INCLUDEPATH += clock
TARGET	 = clock

Компилируем, получаем библиотеку.
Это все описано в документации, теперь несколько дополнений, ради которых собственно я и решил написать статью.

Добавить свойство

Необходимо добавить экспортное свойство класса. Для примера возьмем некое name;
Доработаем класс Clock

   // .................
    Q_OBJECT
    Q_CLASSINFO("ClassID", "{1edd41d0-e01f-445d-9b4e-78c99ab93acf}")
    Q_CLASSINFO("InterfaceID", "{8adccb5c-567e-42f6-8b81-f6634409fb1a}")
    Q_CLASSINFO("EventsID", "{f0a4474f-8c0c-4cdf-985d-8379b26bdd19}")
    // добавим свойство name
    Q_PROPERTY(QString name READ getName WRITE setName)

public:
   // функция получения свойства 
    QString getName()const
    {
        if(name.isEmpty())
            return "Clock";
        else
            return name;
    }
   // функция установки свойства
    void setName(const QString &inName){name = inName;}
private:
    QString name;
// .......

Добавить метод

Методы добавляются через публичные слоты в классе Clock:

// .......
public slots:
    void function(int a);
    QString functionb(const QString &b);
// .......

Добавить событие

Событие, реакцию на которое вы хотите реализовать в алгоритме использующем AXControl, добавляется через сигналы, ниже пример, правда из другого класса:

// в классе создаем сигнал
signals:
    void mouseDbClick(int x, int y);

// переопределяем событие
protected:

    void mouseDoubleClickEvent(QMouseEvent *event) 
    {
        QPoint pos = event->pos();
        emit mouseDbClick(pos.rx(), pos.ry());
    }

Заключение

Библиотека Qt отличная вещь, может очень многое, нужно учится ее готовить.

Отдельная благодарность автору статьи о создании динамических библиотек Qt.
Полезные ресурсы, которые помогли в решении задачи doc.crossplatform.ru/qt и qt-project.org

Автор: theshadowco

Источник