Member Function Documentation

QAxBindable::​QAxBindable()

Constructs an empty QAxBindable object.

[virtual] QAxBindable::​~QAxBindable()

Destroys the QAxBindable object.

[protected] IUnknown * QAxBindable::​clientSite() const

Returns a pointer to the client site interface for this ActiveX object, or null if no client site has been set.

Call QueryInterface() on the returned interface to get the interface you want to call.

[virtual] QAxAggregated * QAxBindable::​createAggregate()

Reimplement this function when you want to implement additional COM interfaces in the ActiveX control, or when you want to provide alternative implementations of COM interfaces. Return a new object of a QAxAggregated subclass.

The default implementation returns the null pointer.

[protected] void QAxBindable::​propertyChanged(const char * property)

Call this function to notify the client that is hosting this ActiveX control that the property property has been changed.

This function is usually called at the end of the property's write function.

See also requestPropertyChange().

[virtual] bool QAxBindable::​readData(QIODevice * source, const QString & format)

If the COM object supports a MIME type then this function is called to initialize the COM object from the data source in format. You have to open source for reading before you can read from it.

Returns true to indicate success. If the function returns false, then ActiveQt will process the data by setting the properties through the meta object system.

If you reimplement this function you also have to implement writeData(). The default implementation does nothing and returns false.

Warning: ActiveX controls embedded in HTML can use either the type and data attribute of the object tag to read data, or use a list of param tags to initialize properties. If param tags are used, then Internet Explorer will ignore the data attribute, and readData will not be called.

This function was introduced in Qt 4.1.

See also writeData().

void QAxBindable::​reportError(int code, const QString & src, const QString & desc, const QString & context = QString())

Reports an error to the client application. code is a control-defined error code. desc is a human-readable description of the error intended for the application user. src is the name of the source for the error, typically the ActiveX server name. context can be the location of a help file with more information about the error. If context ends with a number in brackets, e.g. [12], this number will be interpreted as the context ID in the help file.

[protected] bool QAxBindable::​requestPropertyChange(const char * property)

Call this function to request permission to change the property property from the client that is hosting this ActiveX control. Returns true if the client allows the change; otherwise returns false.

This function is usually called first in the write function for property, and writing is abandoned if the function returns false.

void MyActiveQt::setText(const QString &text)
{
    if (!requestPropertyChange("text"))
        return;

    // update property

    propertyChanged("text");
}

See also propertyChanged().

[virtual] bool QAxBindable::​writeData(QIODevice * sink)

If the COM object supports a MIME type then this function is called to store the COM object into sink. You have to open sink for writing before you can write to it.

Returns true to indicate success. If the function returns false, then ActiveQt will serialize the object by storing the property values.

If you reimplement this function you also have to implement readData(). The default implementation does nothing and returns false.

This function was introduced in Qt 4.1.

See also readData().