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.

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