qaxbase.h File Reference

#include <QtCore/qdatastream.h>
#include <QtCore/qmap.h>
#include <QtCore/qobject.h>
#include <QtCore/qvariant.h>

Go to the source code of this file.

Classes
class	QAxBase
	The QAxBase class is an abstract class that provides an API to initialize and access a COM object. More...

Macros
#define	Q_COM_METATYPE_DECLARED

Functions
QDataStream &	operator<< (QDataStream &s, const QAxBase &c)
QDataStream &	operator>> (QDataStream &s, QAxBase &c)
QString	qax_generateDocumentation (QAxBase *)
template<>
QAxBase *	qobject_cast< QAxBase * > (const QObject *o)
template<>
QAxBase *	qobject_cast< QAxBase * > (QObject *o)

Macro Definition Documentation

Q_COM_METATYPE_DECLARED

#define Q_COM_METATYPE_DECLARED

Definition at line 216 of file qaxbase.h.

Function Documentation

operator<<()

QDataStream& operator<< ( QDataStream &  s, const QAxBase &  c  )

inline

Definition at line 203 of file qaxbase.h.

Referenced by qrgb444::byte_mul(), qt_mix_colors(), QBezier::shifted(), and QSpanCollection::spansInRect().

{
    QAxBase::PropertyBag bag = c.propertyBag();
    s << c.control();
    s << bag;
    
    return s;
}

operator>>()

QDataStream& operator>> ( QDataStream &  s, QAxBase &  c  )

inline

Definition at line 189 of file qaxbase.h.

Referenced by qt_mix_colors().

{
    QAxBase::PropertyBag bag;
    c.qObject()->blockSignals(true);
    QString control;
    s >> control;
    c.setControl(control);
    s >> bag;
    c.setPropertyBag(bag);
    c.qObject()->blockSignals(false);
    
    return s;
}

qax_generateDocumentation()

QString qax_generateDocumentation

(

QAxBase *

)

Definition at line 130 of file qaxdump.cpp.

Referenced by QAxBase::generateDocumentation(), and qobject_cast< QAxBase * >().

{
    that->metaObject();

    if (that->isNull())
    return QString();

    ITypeInfo *typeInfo = 0;
    IDispatch *dispatch = 0;
    that->queryInterface(IID_IDispatch, (void**)&dispatch);
    if (dispatch)
    dispatch->GetTypeInfo(0, LOCALE_SYSTEM_DEFAULT, &typeInfo);

    QString docu;
    QTextStream stream(&docu, QIODevice::WriteOnly);

    const QMetaObject *mo = that->metaObject();
    QString coClass  = QLatin1String(mo->classInfo(mo->indexOfClassInfo("CoClass")).value());

    stream << "<h1 align=center>" << coClass << " Reference</h1>" << endl;
    stream << "<p>The " << coClass << " COM object is a " << that->qObject()->metaObject()->className();
    stream << " with the CLSID " <<  that->control() << ".</p>" << endl;

    stream << "<h3>Interfaces</h3>" << endl;
    stream << "<ul>" << endl;
    const char *inter = 0;
    int interCount = 1;
    while ((inter = mo->classInfo(mo->indexOfClassInfo("Interface " + QByteArray::number(interCount))).value())) {
    stream << "<li>" << inter << endl;
    interCount++;
    }
    stream << "</ul>" << endl;

    stream << "<h3>Event Interfaces</h3>" << endl;
    stream << "<ul>" << endl;
    interCount = 1;  
    while ((inter = mo->classInfo(mo->indexOfClassInfo("Event Interface " + QByteArray::number(interCount))).value())) {
    stream << "<li>" << inter << endl;
    interCount++;
    }
    stream << "</ul>" << endl;

    QList<QString> methodDetails, propDetails;

    const int slotCount = mo->methodCount();
    if (slotCount) {
    stream << "<h2>Public Slots:</h2>" << endl;
    stream << "<ul>" << endl;

        int defArgCount = 0;
    for (int islot = mo->methodOffset(); islot < slotCount; ++islot) {
        const QMetaMethod slot = mo->method(islot);
            if (slot.methodType() != QMetaMethod::Slot)
                continue;

            if (slot.attributes() & QMetaMethod::Cloned) {
                ++defArgCount;
                continue;
            }

        QByteArray returntype(slot.typeName());
            if (returntype.isEmpty())
                returntype = "void";
            QByteArray prototype = namedPrototype(slot.parameterTypes(), slot.parameterNames(), defArgCount);
            QByteArray signature = slot.signature();
        QByteArray name = signature.left(signature.indexOf('('));
        stream << "<li>" << returntype << " <a href=\"#" << name << "\"><b>" << name << "</b></a>" << prototype << ";</li>" << endl;
            
            prototype = namedPrototype(slot.parameterTypes(), slot.parameterNames());
        QString detail = QString::fromLatin1("<h3><a name=") + QString::fromLatin1(name.constData()) + QLatin1String("></a>") +
                             QLatin1String(returntype.constData()) + QLatin1Char(' ') +
                             QLatin1String(name.constData()) + QLatin1Char(' ') +
                             QString::fromLatin1(prototype.constData()) + QLatin1String("<tt> [slot]</tt></h3>\n");
            prototype = namedPrototype(slot.parameterTypes(), QList<QByteArray>());
        detail += docuFromName(typeInfo, QString::fromLatin1(name.constData()));
        detail += QLatin1String("<p>Connect a signal to this slot:<pre>\n");
        detail += QString::fromLatin1("\tQObject::connect(sender, SIGNAL(someSignal") + QString::fromLatin1(prototype.constData()) +
                      QLatin1String("), object, SLOT(") + QString::fromLatin1(name.constData()) +
                      QString::fromLatin1(prototype.constData()) + QLatin1String("));");
        detail += QLatin1String("</pre>\n");

            if (1) {
                detail += QLatin1String("<p>Or call the function directly:<pre>\n");

                bool hasParams = slot.parameterTypes().count() != 0;
                if (hasParams)
                    detail += QLatin1String("\tQVariantList params = ...\n");
                detail += QLatin1String("\t");
                QByteArray functionToCall = "dynamicCall";
                if (returntype == "IDispatch*" || returntype == "IUnknown*") {
                    functionToCall = "querySubObject";
                    returntype = "QAxObject *";
                }
                if (returntype != "void")
                    detail += QLatin1String(returntype.constData()) + QLatin1String(" result = ");
                detail += QLatin1String("object->") + QLatin1String(functionToCall.constData()) +
                          QLatin1String("(\"" + name + prototype + '\"');
                if (hasParams)
                    detail += QLatin1String(", params");
                detail += QLatin1Char(')');
                if (returntype != "void" && returntype != "QAxObject *" && returntype != "QVariant")
                    detail += QLatin1Char('.') + QLatin1String(toType(returntype));
            detail += QLatin1String(";</pre>\n");
        } else {
        detail += QLatin1String("<p>This function has parameters of unsupported types and cannot be called directly.");
        }

        methodDetails << detail;
            defArgCount = 0;
    }

    stream << "</ul>" << endl;
    }
    int signalCount = mo->methodCount();
    if (signalCount) {
        ITypeLib *typeLib = 0;
        if (typeInfo) {
            UINT index = 0;
            typeInfo->GetContainingTypeLib(&typeLib, &index);
            typeInfo->Release();
        }
        typeInfo = 0;

    stream << "<h2>Signals:</h2>" << endl;
    stream << "<ul>" << endl;

    for (int isignal = mo->methodOffset(); isignal < signalCount; ++isignal) {
        const QMetaMethod signal(mo->method(isignal));
            if (signal.methodType() != QMetaMethod::Signal)
                continue;

            QByteArray prototype = namedPrototype(signal.parameterTypes(), signal.parameterNames());
        QByteArray signature = signal.signature();
        QByteArray name = signature.left(signature.indexOf('('));
        stream << "<li>void <a href=\"#" << name << "\"><b>" << name << "</b></a>" << prototype << ";</li>" << endl;

            QString detail = QLatin1String("<h3><a name=") + QLatin1String(name.constData()) + QLatin1String("></a>void ") +
                             QLatin1String(name.constData()) + QLatin1Char(' ') +
                             QLatin1String(prototype.constData()) + QLatin1String("<tt> [signal]</tt></h3>\n");
            if (typeLib) {
                interCount = 0;
                do {
                    if (typeInfo)
                        typeInfo->Release();
                    typeInfo = 0;
                    typeLib->GetTypeInfo(++interCount, &typeInfo);
                    QString typeLibDocu = docuFromName(typeInfo, QString::fromLatin1(name.constData()));
                    if (!typeLibDocu.isEmpty()) {
                        detail += typeLibDocu;
                        break;
                    }
                } while (typeInfo);
            }
            prototype = namedPrototype(signal.parameterTypes(), QList<QByteArray>());
        detail += QLatin1String("<p>Connect a slot to this signal:<pre>\n");
        detail += QLatin1String("\tQObject::connect(object, SIGNAL(") + QString::fromLatin1(name.constData()) +
                      QString::fromLatin1(prototype.constData()) +
                      QLatin1String("), receiver, SLOT(someSlot") + QString::fromLatin1(prototype.constData()) + QLatin1String("));");
        detail += QLatin1String("</pre>\n");

        methodDetails << detail;
            if (typeInfo)
                typeInfo->Release();
            typeInfo = 0;
    }
    stream << "</ul>" << endl;

        if (typeLib)
            typeLib->Release();
    }

    const int propCount = mo->propertyCount();
    if (propCount) {
        if (dispatch)
        dispatch->GetTypeInfo(0, LOCALE_SYSTEM_DEFAULT, &typeInfo);
    stream << "<h2>Properties:</h2>" << endl;
    stream << "<ul>" << endl;

    for (int iprop = 0; iprop < propCount; ++iprop) {
        const QMetaProperty prop = mo->property(iprop);
        QByteArray name(prop.name());
        QByteArray type(prop.typeName());

        stream << "<li>" << type << " <a href=\"#" << name << "\"><b>" << name << "</b></a>;</li>" << endl;
        QString detail = QLatin1String("<h3><a name=") + QString::fromLatin1(name.constData()) + QLatin1String("></a>") +
                             QLatin1String(type.constData()) +
                     QLatin1Char(' ') + QLatin1String(name.constData()) + QLatin1String("</h3>\n");
        detail += docuFromName(typeInfo, QString::fromLatin1(name));
        QVariant::Type vartype = QVariant::nameToType(type);
        if (!prop.isReadable())
        continue;

        if (prop.isEnumType())
        vartype = QVariant::Int;

            if (vartype != QVariant::Invalid) {
        detail += QLatin1String("<p>Read this property's value using QObject::property:<pre>\n");
                if (prop.isEnumType())
            detail += QLatin1String("\tint val = ");
                else
                    detail += QLatin1Char('\t') + QLatin1String(type.constData()) + QLatin1String(" val = ");
        detail += QLatin1String("object->property(\"") + QLatin1String(name.constData()) +
                          QLatin1String("\").") + QLatin1String(toType(type).constData()) + QLatin1String(";\n");
        detail += QLatin1String("</pre>\n");
        } else if (type == "IDispatch*" || type == "IUnknown*") {
        detail += QLatin1String("<p>Get the subobject using querySubObject:<pre>\n");
        detail += QLatin1String("\tQAxObject *") + QLatin1String(name.constData()) +
                          QLatin1String(" = object->querySubObject(\"") + QLatin1String(name.constData()) + QLatin1String("\");\n");
        detail += QLatin1String("</pre>\n");
        } else {
        detail += QLatin1String("<p>This property is of an unsupported type.\n");
        }
        if (prop.isWritable()) {
        detail += QLatin1String("Set this property' value using QObject::setProperty:<pre>\n");
                if (prop.isEnumType()) {
                    detail += QLatin1String("\tint newValue = ... // string representation of values also supported\n");
                } else {
            detail += QLatin1String("\t") + QString::fromLatin1(type.constData()) + QLatin1String(" newValue = ...\n");
                }
        detail += QLatin1String("\tobject->setProperty(\"") + QString::fromLatin1(name) + QLatin1String("\", newValue);\n");
        detail += QLatin1String("</pre>\n");
        detail += QLatin1String("Or using the ");
        QByteArray setterSlot;
                if (isupper(name.at(0))) {
            setterSlot = "Set" + name;
        } else {
            QByteArray nameUp = name;
            nameUp[0] = toupper(nameUp.at(0));
            setterSlot = "set" + nameUp;
        }
        detail += QLatin1String("<a href=\"#") + QString::fromLatin1(setterSlot) + QLatin1String("\">") +
                          QString::fromLatin1(setterSlot.constData()) + QLatin1String("</a> slot.\n");
        }
        if (prop.isEnumType()) {
        detail += QLatin1String("<p>See also <a href=\"#") + QString::fromLatin1(type) +
                QLatin1String("\">") + QString::fromLatin1(type) + QLatin1String("</a>.\n");
        }

        propDetails << detail;
    }
    stream << "</ul>" << endl;
    }

    const int enumCount = mo->enumeratorCount();
    if (enumCount) {
    stream << "<hr><h2>Member Type Documentation</h2>" << endl;
    for (int i = 0; i < enumCount; ++i) {
        const QMetaEnum enumdata = mo->enumerator(i);
        stream << "<h3><a name=" << enumdata.name() << "></a>" << enumdata.name() << "</h3>" << endl;
        stream << "<ul>" << endl;
        for (int e = 0; e < enumdata.keyCount(); ++e) {
        stream << "<li>" << enumdata.key(e) << "\t=" << enumdata.value(e) << "</li>" << endl;
        }
        stream << "</ul>" << endl;
    }
    }
    if (methodDetails.count()) {
    stream << "<hr><h2>Member Function Documentation</h2>" << endl;
    for (int i = 0; i < methodDetails.count(); ++i)
        stream << methodDetails.at(i) << endl;
    }
    if (propDetails.count()) {
    stream << "<hr><h2>Property Documentation</h2>" << endl;
    for (int i = 0; i < propDetails.count(); ++i)
        stream << propDetails.at(i) << endl;
    }

    if (typeInfo)
        typeInfo->Release();
    if (dispatch)
        dispatch->Release();
    return docu;
}

qobject_cast< QAxBase * >() [1/2]

template<>

QAxBase* qobject_cast< QAxBase *> ( const QObject *  o )

inline

Definition at line 164 of file qaxbase.h.

{
    void *result = o ? const_cast<QObject *>(o)->qt_metacast("QAxBase") : 0;
    return (QAxBase*)(result);
}

qobject_cast< QAxBase * >() [2/2]

template<>

QAxBase* qobject_cast< QAxBase *> ( QObject *  o )

inline

Definition at line 174 of file qaxbase.h.

{
    void *result = o ? o->qt_metacast("QAxBase") : 0;
    return (QAxBase*)(result);
}