QAxBindable Class

成员函数文档

QAxBindable::QAxBindable()

创建一个空的 QAxBindable 对象。

[virtual noexcept] QAxBindable::~QAxBindable()

销毁QAxBindable 对象。

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

返回指向此 ActiveX 对象客户端接口的指针；如果未设置客户端，则返回 null。

在返回的接口上调用QueryInterface() 方法，以获取要调用的接口。

[virtual] QAxAggregated *QAxBindable::createAggregate()

当您希望在 ActiveX 控件中实现其他 COM 接口，或者希望为 COM 接口提供替代实现时，请重新实现此函数。返回一个QAxAggregated 子类的新对象。

默认实现返回空指针。

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

调用此函数可通知托管此 ActiveX 控件的客户端，property 属性已发生更改。

该函数通常在该属性的写入函数结束时被调用。

另请参阅 requestPropertyChange()。

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

如果 COM 对象支持 MIME 类型，则会调用此函数，根据format 中的数据source 初始化该 COM 对象。在从source 读取数据之前，必须先以读取模式打开该文件。

返回 true 表示成功。如果函数返回 false，则 ActiveQt 将通过元对象系统设置属性来处理数据。

若重写此函数，还必须实现writeData()。默认实现不执行任何操作并返回 false。

另请参阅 writeData()。

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

向客户端应用程序报告错误。code 是控件定义的错误代码。desc 是面向应用程序用户的、易于理解的错误描述。src 是错误来源的名称，通常为ActiveX服务器名称。context 可以是包含该错误更多信息的帮助文件的位置。 如果context 以方括号中的数字结尾（例如 [12]），该数字将在帮助文件中被解释为上下文 ID。

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

调用此函数以向托管此 ActiveX 控件的客户端请求更改属性property 的权限。如果客户端允许更改，则返回 true；否则返回 false。

该函数通常在property 的写入函数中首先被调用，如果该函数返回false，则放弃写入操作。

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

    // update property

    propertyChanged("text");
}

另请参阅 propertyChanged()。

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

如果 COM 对象支持 MIME 类型，则会调用此函数将 COM 对象存储到sink 中。在向sink 写入数据之前，必须先以写入模式打开该文件。

返回 true 表示操作成功。如果函数返回 false，则 ActiveQt 将通过存储属性值来序列化该对象。

若重写此函数，还必须实现readData()。默认实现不执行任何操作并返回 false。

另请参阅 readData()。