QAxObject Class
QAxObject 클래스는 COM 개체를 래핑하는 QObject 를 제공합니다. 더 보기...
| 헤더: | #include <qaxobject.h> |
| CMake: | find_package(Qt6 REQUIRED COMPONENTS AxContainer) target_link_libraries(mytarget PRIVATE Qt6::AxContainer) |
| qmake: | QT += axcontainer |
| 상속: | QAxBaseObject 그리고 QAxBase |
| 상속받는 클래스: |
공개 함수
| QAxObject(QObject *parent = nullptr) | |
| QAxObject(IUnknown *iface, QObject *parent = nullptr) | |
| QAxObject(const QString &c, QObject *parent = nullptr) | |
| virtual | ~QAxObject() override |
| bool | doVerb(const QString &verb) |
재구현된 보호 함수
| virtual void | connectNotify(const QMetaMethod &signal) override |
상세 설명
QAxObject는 빈 객체로, 래핑할 COM 객체의 이름을 지정하여, 또는 기존 COM 객체를 나타내는 IUnknown 포인터를 사용하여 인스턴스화할 수 있습니다. COM 객체가 IDispatch 인터페이스를 구현하는 경우, 해당 객체의 속성, 메서드 및 이벤트는 Qt 속성, 슬롯 및 시그널로 사용할 수 있게 됩니다. 기초 클래스인 ` QAxBase`는 `IUnknown` 포인터를 통해 COM 객체에 직접 접근할 수 있는 API를 제공합니다.
QAxObject는 QObject 이며, 그 자체로 사용할 수 있습니다. 예를 들어, 객체 계층 구조로 구성하거나, 이벤트를 수신하거나, 신호 및 슬롯에 연결할 수 있습니다.
또한 QAxObject는 ActiveX 관련 기능 대부분을 QAxBase 에서 상속받는데, 특히 dynamicCall() 및 querySubObject()가 있습니다.
QAxBase, QAxWidget, QAxScript 및 ActiveQt Framework항목도 참조하십시오 .
멤버 함수 문서
[explicit] QAxObject::QAxObject(QObject *parent = nullptr)
빈 COM 객체를 생성하고 ` parent `를 ` QObject ` 생성자에 전달합니다. 객체를 초기화하려면 `setControl()`을 호출하십시오.
setControl()도 참조하십시오 .
[explicit] QAxObject::QAxObject(IUnknown *iface, QObject *parent = nullptr)
iface 에서 참조하는 COM 개체를 래핑하는 QAxObject를 생성합니다. parent 는 QObject 생성자로 전달됩니다.
[explicit] QAxObject::QAxObject(const QString &c, QObject *parent = nullptr)
COM 객체 ` c`를 래핑하는 `QAxObject`를 생성합니다. ` parent `는 ` QObject ` 생성자로 전달됩니다.
setControl()도 참조하십시오 .
[override virtual noexcept] QAxObject::~QAxObject()
COM 개체를 해제하고 ` QAxObject`를 소멸시켜, 할당된 모든 리소스를 정리합니다.
[override virtual protected] void QAxObject::connectNotify(const QMetaMethod &signal)
QObject::connectNotify(const QMetaMethod &signal)을 재구현합니다.
bool QAxObject::doVerb(const QString &verb)
COM 객체에 verb 작업을 수행하도록 요청합니다. 사용 가능한 동사 목록은 verbs() 함수를 통해 반환됩니다.
객체가 해당 작업을 수행할 수 있는 경우 이 함수는 true를 반환하고, 그렇지 않은 경우 false를 반환합니다.
© 2026 The Qt Company Ltd. Documentation contributions included herein are the copyrights of their respective owners. The documentation provided herein is licensed under the terms of the GNU Free Documentation License version 1.3 as published by the Free Software Foundation. Qt and respective logos are trademarks of The Qt Company Ltd. in Finland and/or other countries worldwide. All other trademarks are property of their respective owners.
