QAxSelect Class

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

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

List of all members, including inherited members

Public Types

enum	SandboxingLevel { SandboxingNone, SandboxingProcess, SandboxingLowIntegrity, SandboxingAppContainer }

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

enum QAxSelect::SandboxingLevel

The SandboxingLevel enumeration defines the desired level of ActiveX sandboxing.

Constant	Value	Description
`QAxSelect::SandboxingNone`	`0`	No specific sandboxing desired
`QAxSelect::SandboxingProcess`	`1`	Run ActiveX control in a separate process
`QAxSelect::SandboxingLowIntegrity`	`2`	Run ActiveX control in a separate low-integrity process
`QAxSelect::SandboxingAppContainer`	`3`	[since 6.5] Run ActiveX control in a separate AppContainer-isolated process

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

Member Function Documentation

`[explicit]` 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 noexcept]` QAxSelect::~QAxSelect()

Destroys the QAxSelect object.

QString QAxSelect::clsid() const

Returns the CLSID of the selected COM component.

QAxSelect::SandboxingLevel QAxSelect::sandboxingLevel() const

Returns the desired level of sandboxing for the ActiveX control.

Contents