QAxBindable Class

Dokumentation der Mitgliedsfunktionen

QAxBindable::QAxBindable()

Konstruiert ein leeres QAxBindable-Objekt.

[virtual noexcept] QAxBindable::~QAxBindable()

Zerstört das Objekt QAxBindable.

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

Gibt einen Zeiger auf die Client-Site-Schnittstelle für dieses ActiveX-Objekt zurück, oder null, wenn keine Client-Site festgelegt wurde.

Rufen Sie QueryInterface() für die zurückgegebene Schnittstelle auf, um die Schnittstelle zu erhalten, die Sie aufrufen möchten.

[virtual] QAxAggregated *QAxBindable::createAggregate()

Reimplementieren Sie diese Funktion, wenn Sie zusätzliche COM-Schnittstellen im ActiveX-Steuerelement implementieren möchten, oder wenn Sie alternative Implementierungen von COM-Schnittstellen bereitstellen möchten. Gibt ein neues Objekt einer QAxAggregated Unterklasse zurück.

Die Standardimplementierung gibt den Null-Zeiger zurück.

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

Rufen Sie diese Funktion auf, um den Client, der dieses ActiveX-Steuerelement hostet, darüber zu informieren, dass die Eigenschaft property geändert wurde.

Diese Funktion wird normalerweise am Ende der Schreibfunktion der Eigenschaft aufgerufen.

Siehe auch requestPropertyChange().

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

Wenn das COM-Objekt einen MIME-Typ unterstützt, wird diese Funktion aufgerufen, um das COM-Objekt aus den Daten source in format zu initialisieren. Sie müssen source zum Lesen öffnen, bevor Sie aus ihm lesen können.

Gibt true zurück, um den Erfolg anzuzeigen. Wenn die Funktion false zurückgibt, verarbeitet ActiveQt die Daten, indem es die Eigenschaften über das Meta-Objektsystem setzt.

Wenn Sie diese Funktion neu implementieren, müssen Sie auch writeData() implementieren. Die Standardimplementierung tut nichts und gibt false zurück.

Siehe auch writeData().

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

Meldet einen Fehler an die Client-Anwendung. code ist ein vom Steuerelement definierter Fehlercode. desc ist eine vom Menschen lesbare Beschreibung des Fehlers, die für den Benutzer der Anwendung bestimmt ist. src ist der Name der Fehlerquelle, in der Regel der Name des ActiveX-Servers. context kann der Speicherort einer Hilfedatei mit weiteren Informationen über den Fehler sein. Wenn context mit einer Zahl in Klammern endet, z. B. [12], wird diese Zahl als die Kontext-ID in der Hilfedatei interpretiert.

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

Rufen Sie diese Funktion auf, um von dem Client, der dieses ActiveX-Steuerelement hostet, die Erlaubnis zum Ändern der Eigenschaft property anzufordern. Gibt true zurück, wenn der Client die Änderung erlaubt; andernfalls wird false zurückgegeben.

Diese Funktion wird normalerweise zuerst in der Schreibfunktion für property aufgerufen, und das Schreiben wird abgebrochen, wenn die Funktion false zurückgibt.

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

    // update property

    propertyChanged("text");
}

Siehe auch propertyChanged().

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

Wenn das COM-Objekt einen MIME-Typ unterstützt, wird diese Funktion aufgerufen, um das COM-Objekt in sink zu speichern. Sie müssen sink zum Schreiben öffnen, bevor Sie in das Objekt schreiben können.

Gibt true zurück, um den Erfolg anzuzeigen. Wenn die Funktion false zurückgibt, wird ActiveQt das Objekt serialisieren, indem es die Eigenschaftswerte speichert.

Wenn Sie diese Funktion neu implementieren, müssen Sie auch readData() implementieren. Die Standardimplementierung tut nichts und gibt false zurück.

Siehe auch readData().