QAxWidget Class

멤버 함수 문서

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

빈 QAxWidget 위젯을 생성하고 parent 및 f 을 QWidget 생성자에 전파합니다. 컨트롤을 초기화하려면 setControl()를 호출합니다.

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

iface 에서 참조하는 COM 객체를 래핑하는 QAxWidget을 생성합니다. parent 및 f 은 QWidget 생성자로 전파됩니다.

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

QAxWidget 위젯을 생성하고 ActiveX 컨트롤을 초기화합니다 c. parent 및 f 은 QWidget 생성자로 전파됩니다.

setControl()도 참조하세요 .

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

ActiveX 컨트롤을 종료하고 QAxWidget 위젯을 삭제하여 할당된 모든 리소스를 정리합니다.

clear()도 참조하세요 .

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

다시 구현합니다: QWidget::changeEvent(QEvent * 이벤트).

void QAxWidget::clear()

ActiveX 컨트롤을 종료합니다.

resetControl()도 참조하세요 .

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

재구현합니다: QObject::connectNotify(const QMetaMethod &signal).

[virtual] QAxAggregated *QAxWidget::createAggregate()

ActiveX 컨트롤의 클라이언트 사이트에 대한 추가 COM 인터페이스를 구현하거나 COM 인터페이스의 대체 구현을 제공하려는 경우 이 함수를 다시 구현합니다. QAxAggregated 서브클래스의 새 객체를 반환합니다.

기본 구현은 널 포인터를 반환합니다.

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

ActiveX 컨트롤의 클라이언트 사이트를 생성하고 컨트롤을 성공적으로 임베드할 수 있으면 참을 반환하고 그렇지 않으면 거짓을 반환합니다. initialized 이 참이면 컨트롤이 이미 초기화된 것입니다.

이 함수는 initialize()에 의해 호출됩니다. 실제 컨트롤 인스턴스화를 사용자 지정하기 위해 초기화를 다시 구현하는 경우, 다시 구현할 때 이 함수를 호출하여 기본 클라이언트 측에서 컨트롤을 임베드하도록 합니다. ActiveX 컨트롤의 클라이언트 사이트를 생성하고 컨트롤을 성공적으로 임베드할 수 있으면 true를 반환하고, 그렇지 않으면 false를 반환합니다.

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

ActiveX 컨트롤의 클라이언트 사이트를 생성하고 컨트롤을 성공적으로 임베드할 수 있으면 참을 반환하고 그렇지 않으면 거짓을 반환합니다. initialized 이 거짓이면 컨트롤은 data 을 사용하여 초기화됩니다. 컨트롤은 IPersistStreamInit 또는 IPersistStorage 인터페이스를 통해 초기화됩니다.

사용자 지정 데이터를 사용하여 컨트롤을 초기화해야 하는 경우 initialize()의 재구현에서 이 함수를 호출합니다. 이 함수는 initialize()의 기본 구현에서는 호출되지 않습니다.

bool QAxWidget::doVerb(const QString &verb)

작업을 수행하기 위해 ActiveX 컨트롤을 요청합니다 verb. 가능한 동사는 verbs()로 반환됩니다.

이 함수는 객체가 동작을 수행할 수 있으면 참을 반환하고, 그렇지 않으면 거짓을 반환합니다.

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

다시 구현합니다: QAxBase::initialize(IUnknown **ptr).

QAxBase::initialize(ptr)를 호출하고 성공하면 createHostWindow(false)를 호출하여 이 위젯에 컨트롤을 임베드합니다.

컨트롤을 활성화하기 전에 초기화하려면 이 함수를 다시 구현하고 createHostWindow(참)을 호출하기 전에 초기화 코드를 추가합니다.

성공하면 true, 그렇지 않으면 false 을 반환합니다.

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

속성에 대한 액세스 함수를 다시 구현합니다: QWidget::minimumSizeHint.

[override virtual] void QAxWidget::resetControl()

다시 구현합니다: QAxObjectInterface::resetControl().

ActiveX 컨트롤을 종료합니다.

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

다시 구현합니다: QWidget::resizeEvent(QResizeEvent * 이벤트).

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

속성에 대한 액세스 함수를 다시 구현합니다: QWidget::sizeHint.

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

이 함수를 다시 구현하여 특정 키 이벤트를 ActiveX 컨트롤에 전달합니다. message 은 메시지 유형을 지정하는 윈도우 메시지 식별자(예: WM_KEYDOWN)이고 keycode 은 가상 키코드(예: VK_TAB)입니다.

함수가 참을 반환하면 키 이벤트가 ActiveX 컨트롤로 전달되고, 이 컨트롤은 이벤트를 처리하거나 Qt로 이벤트를 전달합니다.

함수가 false를 반환하면 키 이벤트 처리는 ActiveQt에 의해 무시됩니다. 즉, ActiveX 컨트롤이 처리할 수도 있고 처리하지 않을 수도 있습니다.

기본 구현은 다음과 같은 경우에 참을 반환합니다:

이 표는 널리 사용되는 ActiveX 컨트롤(예: Internet Explorer 및 Microsoft Office 애플리케이션)을 실험한 결과이지만 일부 컨트롤의 경우 수정이 필요할 수 있습니다.