QAxScriptEngine Class
QAxScriptEngine 类提供了一个用于封装脚本引擎的包装类。更多内容...
| 标题： | #include <qaxscript.h> |
| CMake： | find_package(Qt6 REQUIRED COMPONENTS AxContainer) target_link_libraries(mytarget PRIVATE Qt6::AxContainer) |
| qmake： | QT += axcontainer |
| 继承自： | QAxObject |
公共类型
| enum | State { Uninitialized, Initialized, Started, Connected, Disconnected, Closed } |
公共函数
| QAxScriptEngine(const QString &language, QAxScript *script) | |
| virtual | ~QAxScriptEngine() override |
| void | addItem(const QString &name) |
| bool | hasIntrospection() const |
| bool | isValid() const |
| long | queryInterface(const QUuid &uuid, void **iface) const |
| QString | scriptLanguage() const |
| void | setState(QAxScriptEngine::State st) |
| QAxScriptEngine::State | state() const |
重新实现的受保护函数
| virtual bool | initialize(IUnknown **ptr) override |
详细说明
QAxScriptEngine 类的每个实例都代表一种特定脚本语言中脚本代码的解释器。该类通常不会被直接使用。QAxScript 和QAxScriptManager 类提供了用于处理和调用脚本代码的便捷函数。
可通过queryInterface() 直接访问脚本引擎。
警告： bcc5.5 编译器不支持此类 。
另请参阅 QAxScript 、QAxScriptManager 、QAxBase 以及ActiveQt 框架。
成员类型文档
enum QAxScriptEngine::State
“状态”枚举定义了脚本引擎可能处于的各种状态。
| 常量 | 值 | 描述 |
|---|---|---|
QAxScriptEngine::Uninitialized | 0 | 脚本已创建，但尚未初始化 |
QAxScriptEngine::Initialized | 5 | 脚本已初始化，但尚未运行 |
QAxScriptEngine::Started | 1 | 脚本可以执行代码，但尚未处理事件 |
QAxScriptEngine::Connected | 2 | 脚本可以执行代码，并且已连接，因此能够处理事件 |
QAxScriptEngine::Disconnected | 3 | 脚本已加载，但未连接到事件源 |
QAxScriptEngine::Closed | 4 | 脚本已关闭。 |
成员函数文档
QAxScriptEngine::QAxScriptEngine(const QString &language, QAxScript *script)
构建一个 QAxScriptEngine 对象，用于解释由script 中的代码提供的位于language 中的脚本代码。这通常由QAxScript 类在loading a script 时完成。
QAxScriptEngine 的实例必须同时拥有语言和脚本。
[override virtual noexcept] QAxScriptEngine::~QAxScriptEngine()
销毁QAxScriptEngine 对象，并释放所有已分配的资源。
void QAxScriptEngine::addItem(const QString &name)
将一个项目注册到脚本引擎中。脚本代码可以使用name 来引用该项目。
bool QAxScriptEngine::hasIntrospection() const
如果脚本引擎支持内省，则返回 true；否则返回 false。
[override virtual protected] bool QAxScriptEngine::initialize(IUnknown **ptr)
重写了：QAxBase::initialize （IUnknown **ptr）。
bool QAxScriptEngine::isValid() const
如果脚本引擎已正确初始化，则返回 true；否则返回 false。
long QAxScriptEngine::queryInterface(const QUuid &uuid, void **iface) const
从脚本引擎对象请求uuid 接口，并将iface 的值设置为所提供的接口；如果无法提供所请求的接口，则将其值设置为0。
返回 COM 对象中 QueryInterface 实现的结果。
QString QAxScriptEngine::scriptLanguage() const
返回脚本语言，例如“VBScript”或“JScript”。
void QAxScriptEngine::setState(QAxScriptEngine::State st)
将脚本引擎的状态设置为st 。通常无需调用此函数。
另请参阅 state()。
QAxScriptEngine::State QAxScriptEngine::state() const
返回脚本引擎的状态。
另请参阅 setState()。
© 2026 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.
