QAxScript Class

Documentación de funciones miembro

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

Construye un objeto QAxScript llamado name y lo registra con la clase QAxScriptManager manager . Esto lo hace normalmente la clase QAxScriptManager cuando loading a script.

Un script siempre debe tener un nombre. Es necesario un gestor para permitir que el código del script haga referencia a objetos de la aplicación. El manager toma posesión del objeto.

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

Destruye el objeto, liberando 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 los parámetros var1, var1, var2, var3, var4, var5, var6, var7 y var8 como argumentos y devuelve el valor devuelto por la función, o un QVariant inválido si la función no devuelve un valor o cuando la llamada a la función falló.

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 cuando la ejecución del script ha finalizado.

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

[signal] void QAxScript::entered()

Esta señal se emite cuando un motor de script 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 durante la ejecución de 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 script ha terminado de ejecutar código.

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

// Or using a lambda:
connect(axScript, qOverload<>(&QAxScript::finished),
        this, []() { /* handle finished */ });

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

result contiene el resultado del script. Este será un QVariant inválido si el script no tiene valor de retorno.

// 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 */ });

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

code, source, description y help contienen información de excepción cuando el script termina.

// 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 */ });

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

Devuelve una lista de 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 sólo como nombres, dependiendo del valor de flags.

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

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

Carga la fuente del script code escrito en el lenguaje language en el motor de script. Devuelve true si code fue introducido con éxito en el motor de scripts; en caso contrario devuelve false.

Si language está vacío (por defecto) se determinará heurísticamente. Si code contiene la cadena End Sub se interpretará como VBScript, en caso contrario como JScript. Se pueden registrar lenguajes de script adicionales utilizando QAxScriptManager::registerEngine().

Esta función sólo puede llamarse una vez por cada objeto QAxScript, lo que se hace 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.

Puede 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 script cambia de estado. state puede ser cualquier valor de la enumeración QAxScriptEngine::State.