En esta página

QAxScript Class

La clase QAxScript proporciona una envoltura para el código de script. Más información...

Encabezado: #include <qaxscript.h>
CMake: find_package(Qt6 REQUIRED COMPONENTS AxContainer)
target_link_libraries(mytarget PRIVATE Qt6::AxContainer)
qmake: QT += axcontainer
Heredado de: QObject

Tipos públicos

enum FunctionFlags { FunctionNames, FunctionSignatures }

Funciones públicas

QAxScript(const QString &name, QAxScriptManager *manager)
virtual ~QAxScript() override
QVariant call(const QString &function, const QVariant &var1 = QVariant(), const QVariant &var2 = QVariant(), const QVariant &var3 = QVariant(), const QVariant &var4 = QVariant(), const QVariant &var5 = QVariant(), const QVariant &var6 = QVariant(), const QVariant &var7 = QVariant(), const QVariant &var8 = QVariant())
QVariant call(const QString &function, QList<QVariant> &arguments)
QStringList functions(QAxScript::FunctionFlags flags = FunctionNames) const
bool load(const QString &code, const QString &language = QString())
QString scriptCode() const
QAxScriptEngine *scriptEngine() const
QString scriptName() const

Señales

void entered()
void error(int code, const QString &description, int sourcePosition, const QString &sourceText)
void finished()
void finished(const QVariant &result)
void finished(int code, const QString &source, const QString &description, const QString &help)
void stateChanged(int state)

Descripción detallada

Cada instancia de la clase QAxScript representa un fragmento de código de script en un lenguaje de script concreto. El código se carga en el motor de script mediante load(). Las funciones declaradas en el código se pueden invocar mediante call().

El script proporciona scriptEngine() envía información a la aplicación a través de señales. La señal más importante es la señal error(). El acceso directo a la clase QAxScriptEngine se realiza mediante la función scriptEngine().

Advertencia: Esta clase no está disponible con el compilador bcc5.5.

Véase también « QAxScriptEngine» , « QAxScriptManager », « QAxBase » y «ActiveQt Framework».

Documentación sobre los tipos de miembros

enum QAxScript::FunctionFlags

Esta enumeración FunctionFlags describe el formato para la introspección de funciones.

ConstanteValorDescripción
QAxScript::FunctionNames0Solo se devuelven los nombres de las funciones.
QAxScript::FunctionSignatures1Devuelve las funciones con sus firmas.

Documentación de funciones de miembro

QAxScript::QAxScript(const QString &name, QAxScriptManager *manager)

Crea un objeto QAxScript denominado « name » y lo registra en el « QAxScriptManager » manager. Normalmente, esto lo lleva a cabo la clase « QAxScriptManager » al loading a script.

Un script siempre debe tener un nombre. Se necesita un gestor para que el código del script pueda hacer referencia a los objetos de la aplicación. El manager asume la propiedad del objeto.

[override virtual noexcept] QAxScript::~QAxScript()

Destruye el objeto y libera todos los recursos asignados.

QVariant QAxScript::call(const QString &function, const QVariant &var1 = QVariant(), const QVariant &var2 = QVariant(), const QVariant &var3 = QVariant(), const QVariant &var4 = QVariant(), const QVariant &var5 = QVariant(), const QVariant &var6 = QVariant(), const QVariant &var7 = QVariant(), const QVariant &var8 = QVariant())

Llama a function, pasando como argumentos los parámetros var1, var1, var2, var3, var4, var5, var6, var7 y var8, y devuelve el valor devuelto por la función, o un QVariant no válido si la función no devuelve ningún valor o si la llamada a la función ha fallado.

Consulte QAxScriptManager::call() para obtener más información sobre cómo llamar a funciones de script.

QVariant QAxScript::call(const QString &function, QList<QVariant> &arguments)

Llama a function pasando arguments como parámetros y devuelve el resultado. Devuelve el resultado cuando finaliza la ejecución del script.

Consulta QAxScriptManager::call() para obtener más información sobre cómo llamar a funciones de script.

Esta es una función sobrecargada.

[signal] void QAxScript::entered()

Esta señal se emite cuando un motor de scripts ha comenzado a ejecutar código.

[signal] void QAxScript::error(int code, const QString &description, int sourcePosition, const QString &sourceText)

Esta señal se emite cuando se produce un error de ejecución al ejecutar un script.

code, description, sourcePosition y sourceText contienen información sobre el error de ejecución.

[signal] void QAxScript::finished()

Esta señal se emite cuando un motor de scripts ha terminado de ejecutar el código.

Nota: Esta señal está sobrecargada. Para conectarse a esta señal:

// Connect using qOverload:
connect(axScript, qOverload<>(&QAxScript::finished),
        receiver, &ReceiverClass::slot);

// Or using a lambda:
connect(axScript, qOverload<>(&QAxScript::finished),
        this, []() { /* handle finished */ });
Para ver más ejemplos y métodos, consulta «Conectarse a señales sobrecargadas».

[signal] void QAxScript::finished(const QVariant &result)

result contiene el resultado del script. Será un objeto ` QVariant ` no válido si el script no tiene valor de retorno.

Nota: Esta señal está sobrecargada. Para conectarse a esta señal:

// Connect using qOverload:
connect(axScript, qOverload(&QAxScript::finished),
        receiver, &ReceiverClass::slot);

// Or using a lambda:
connect(axScript, qOverload(&QAxScript::finished),
        this, [](const QVariant &result) { /* handle finished */ });
Para ver más ejemplos y métodos, consulta «Conexión a señales sobrecargadas».

[signal] void QAxScript::finished(int code, const QString &source, const QString &description, const QString &help)

code, source, description y help contienen información sobre las excepciones que se produjeron al finalizar el script.

Nota: Esta señal está sobrecargada. Para conectarse a esta señal:

// Connect using qOverload:
connect(axScript, qOverload(&QAxScript::finished),
        receiver, &ReceiverClass::slot);

// Or using a lambda:
connect(axScript, qOverload(&QAxScript::finished),
        this, [](int code, const QString &source, const QString &description, const QString &help) { /* handle finished */ });
Para ver más ejemplos y métodos, consulta «Conexión a señales sobrecargadas».

QStringList QAxScript::functions(QAxScript::FunctionFlags flags = FunctionNames) const

Devuelve una lista con todas las funciones de este script si el motor de script correspondiente admite la introspección; en caso contrario, devuelve una lista vacía. Las funciones se proporcionan con prototipos completos o solo como nombres, dependiendo del valor de ` flags`.

Véase también QAxScriptEngine::hasIntrospection().

bool QAxScript::load(const QString &code, const QString &language = QString())

Carga el código fuente del script code, escrito en el lenguaje language, en el motor de scripts. Devuelve «true» si code se ha cargado correctamente en el motor de scripts; en caso contrario, devuelve «false».

Si language está vacío (valor predeterminado), se determinará de forma heurística. Si code contiene la cadena End Sub, se interpretará como VBScript; en caso contrario, como JScript. Se pueden registrar lenguajes de script adicionales mediante QAxScriptManager::registerEngine().

Esta función solo se puede llamar una vez por cada objeto ` QAxScript `, lo cual se realiza automáticamente al utilizar ` QAxScriptManager::load()`.

QString QAxScript::scriptCode() const

Devuelve el código del script o la cadena nula si aún no se ha cargado ningún código.

Véase también load().

QAxScriptEngine *QAxScript::scriptEngine() const

Devuelve un puntero al motor de scripts.

Puedes utilizar el objeto devuelto para conectar señales a las funciones de script o para acceder directamente al motor de script.

QString QAxScript::scriptName() const

Devuelve el nombre del script.

[signal] void QAxScript::stateChanged(int state)

Esta señal se emite cuando un motor de scripts cambia de estado. « state » puede ser cualquier valor de la enumeración « QAxScriptEngine::State ».

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