QAxWidget Class

Dokumentation der Mitgliedsfunktionen

[explicit] QAxWidget::QAxWidget(QWidget *parent = nullptr, Qt::WindowFlags f = Qt::WindowFlags())

Erzeugt ein leeres QAxWidget-Widget und gibt parent und f an den QWidget Konstruktor weiter. Um ein Steuerelement zu initialisieren, rufen Sie setControl() auf.

[explicit] QAxWidget::QAxWidget(IUnknown *iface, QWidget *parent = nullptr, Qt::WindowFlags f = Qt::WindowFlags())

Erzeugt ein QAxWidget, das das von iface referenzierte COM-Objekt umhüllt. parent und f werden an den QWidget -Konstruktor weitergegeben.

[explicit] QAxWidget::QAxWidget(const QString &c, QWidget *parent = nullptr, Qt::WindowFlags f = Qt::WindowFlags())

Erzeugt ein QAxWidget-Widget und initialisiert das ActiveX-Steuerelement c. parent und f werden an den QWidget -Konstruktor weitergegeben.

Siehe auch setControl().

[override virtual noexcept] QAxWidget::~QAxWidget()

Beendet das ActiveX-Steuerelement und zerstört das Widget QAxWidget, wobei alle zugewiesenen Ressourcen aufgeräumt werden.

Siehe auch clear().

[override virtual protected] void QAxWidget::changeEvent(QEvent *e)

Reimplements: QWidget::changeEvent(QEvent *Event).

void QAxWidget::clear()

Schaltet das ActiveX-Steuerelement ab.

Siehe auch resetControl().

[override virtual protected] void QAxWidget::connectNotify(const QMetaMethod &signal)

Reimplements: QObject::connectNotify(const QMetaMethod &signal).

[virtual] QAxAggregated *QAxWidget::createAggregate()

Reimplementieren Sie diese Funktion, wenn Sie zusätzliche COM-Schnittstellen für die Client-Site des ActiveX-Steuerelements 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.

[virtual protected] bool QAxWidget::createHostWindow(bool initialized)

Erzeugt die Client-Site für das ActiveX-Steuerelement und gibt true zurück, wenn das Steuerelement erfolgreich eingebettet werden konnte, andernfalls false. Wenn initialized true ist, wurde das Steuerelement bereits initialisiert.

Diese Funktion wird von initialize() aufgerufen. Wenn Sie initialize neu implementieren, um die tatsächliche Instanzierung des Steuerelements anzupassen, rufen Sie diese Funktion in Ihrer Neuimplementierung auf, damit das Steuerelement von der Standard-Client-Seite eingebettet wird. Erstellt die Client-Site für das ActiveX-Steuerelement und gibt true zurück, wenn das Steuerelement erfolgreich eingebettet werden konnte; andernfalls wird false zurückgegeben.

[protected] bool QAxWidget::createHostWindow(bool initialized, const QByteArray &data)

Erzeugt die Client-Site für das ActiveX-Steuerelement und gibt true zurück, wenn das Steuerelement erfolgreich eingebettet werden konnte, andernfalls false. Wenn initialized false ist, wird das Steuerelement mit der data initialisiert. Das Steuerelement wird entweder über die Schnittstelle IPersistStreamInit oder IPersistStorage initialisiert.

Wenn das Steuerelement mit benutzerdefinierten Daten initialisiert werden muss, rufen Sie diese Funktion in Ihrer Reimplementierung von initialize() auf. Diese Funktion wird nicht von der Standardimplementierung von initialize() aufgerufen.

bool QAxWidget::doVerb(const QString &verb)

Fordert das ActiveX-Steuerelement auf, die Aktion verb auszuführen. Die möglichen Verben werden von verbs() zurückgegeben.

Die Funktion gibt true zurück, wenn das Objekt die Aktion ausführen konnte, andernfalls gibt sie false zurück.

[override virtual protected] bool QAxWidget::initialize(IUnknown **ptr)

Reimplements: QAxBase::initialize(IUnknown **ptr).

Ruft QAxBase::initialize(ptr) auf und bettet das Steuerelement in dieses Widget ein, indem es bei Erfolg createHostWindow(false) aufruft.

Um das Steuerelement zu initialisieren, bevor es aktiviert wird, reimplementieren Sie diese Funktion und fügen Sie Ihren Initialisierungscode hinzu, bevor Sie createHostWindow(true) aufrufen.

Gibt bei Erfolg true zurück, andernfalls false.

[override virtual] QSize QAxWidget::minimumSizeHint() const

Reimplantiert eine Zugriffsfunktion für die Eigenschaft: QWidget::minimumSizeHint.

[override virtual] void QAxWidget::resetControl()

Reimplements: QAxObjectInterface::resetControl().

Schaltet das ActiveX-Steuerelement ab.

[override virtual protected] void QAxWidget::resizeEvent(QResizeEvent *)

Reimplements: QWidget::resizeEvent(QResizeEvent *event).

[override virtual] QSize QAxWidget::sizeHint() const

Reimplantiert eine Zugriffsfunktion für die Eigenschaft: QWidget::sizeHint.

[virtual protected] bool QAxWidget::translateKeyEvent(int message, int keycode) const

Reimplementieren Sie diese Funktion, um bestimmte Tastenereignisse an das ActiveX-Steuerelement zu übergeben. message ist der Window Message Identifier, der den Nachrichtentyp angibt (z.B. WM_KEYDOWN), und keycode ist der virtuelle Tastencode (z.B. VK_TAB).

Wenn die Funktion true zurückgibt, wird das Tastenereignis an das ActiveX-Steuerelement weitergeleitet, das dann entweder das Ereignis verarbeitet oder es an Qt weitergibt.

Wenn die Funktion false zurückgibt, wird die Verarbeitung des Tastenereignisses von ActiveQt ignoriert, d.h. das ActiveX-Steuerelement kann es verarbeiten oder nicht.

Die Standardimplementierung gibt in den folgenden Fällen true zurück:

Diese Tabelle ist das Ergebnis von Experimenten mit gängigen ActiveX-Steuerelementen, z. B. Internet Explorer und Microsoft Office-Anwendungen, aber für einige Steuerelemente sind möglicherweise Änderungen erforderlich.