QAxSelect Class

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

Header: #include <QAxSelect>
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
  • 8 public functions inherited from QDialog
  • 216 public functions inherited from QWidget
  • 30 public functions inherited from QObject
typedef QObjectList
QList<T> qFindChildren(const QObject *obj, const QRegExp &regExp)
T qobject_cast(QObject *object)
T qobject_cast(const QObject *object)

Macros

Additional Inherited Members

  • 2 properties inherited from QDialog
  • 59 properties inherited from QWidget
  • 1 property inherited from QObject
  • 5 public slots inherited from QDialog
  • 19 public slots inherited from QWidget
  • 1 public slot inherited from QObject
  • 3 signals inherited from QDialog
  • 3 signals inherited from QWidget
  • 2 signals inherited from QObject
  • 5 static public members inherited from QWidget
  • 9 static public members inherited from QObject
  • 6 protected functions inherited from QDialog
  • 35 protected functions inherited from QWidget
  • 9 protected functions inherited from QObject
  • 1 protected slot inherited from QWidget

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.

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.

QAxSelect::SandboxingLevel QAxSelect::sandboxingLevel() const

Returns the desired level of sandboxing for the ActiveX control.

This function was introduced in Qt 5.13.