QAxSelect Class

The QAxSelect class provides a selection dialog for registered COM components. More...

Header: #include <QAxSelect>
CMake: find_package(Qt6 COMPONENTS AxContainer REQUIRED)
target_link_libraries(mytarget PRIVATE Qt6::AxContainer)
qmake: QT += axcontainer
Inherits: QDialog

Public Types

enum SandboxingLevel { SandboxingNone, SandboxingProcess, SandboxingLowIntegrity }

Public Functions

QAxSelect(QWidget *parent = nullptr, Qt::WindowFlags flags = Qt::WindowFlags())
virtual ~QAxSelect() override
QString clsid() const
QAxSelect::SandboxingLevel sandboxingLevel() const

Detailed Description

QAxSelect dialog can be used to provide users with a way to browse the registered COM components of the system and select one. It also provides a combo box for selecting desired sandboxing level. The CLSID of the selected component can then be used in the application to e.g. initialize a QAxWidget:

QAxSelect select;
if (select.exec()) {
    QAxWidget *container = new QAxWidget;
    container->setControl(select.clsid());
    container->show();
}

See also QAxWidget and ActiveQt Framework.

Member Type Documentation

[since 5.13] enum QAxSelect::SandboxingLevel

The SandboxingLevel enumeration defines the desired level of ActiveX sandboxing.

ConstantValueDescription
QAxSelect::SandboxingNone0No specific sandboxing desired
QAxSelect::SandboxingProcess1Run ActiveX control in a separate process
QAxSelect::SandboxingLowIntegrity2Run ActiveX control in a separate low-integrity process

Sandboxing requires that the ActiveX is either built as an EXE, or as a DLL with AppID "DllSurrogate" enabled.

This enum was introduced or modified in Qt 5.13.

Member Function Documentation

QAxSelect::QAxSelect(QWidget *parent = nullptr, Qt::WindowFlags flags = Qt::WindowFlags())

Constructs a QAxSelect object. Dialog parent widget and window flags can be optionally specified with parent and flags parameters, respectively.

[override virtual] QAxSelect::~QAxSelect()

Destroys the QAxSelect object.

QString QAxSelect::clsid() const

Returns the CLSID of the selected COM component.

[since 5.13] QAxSelect::SandboxingLevel QAxSelect::sandboxingLevel() const

Returns the desired level of sandboxing for the ActiveX control.

This function was introduced in Qt 5.13.

© 2024 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.