En esta página

QAxScriptManager Class

La clase QAxScriptManager sirve de puente entre los objetos de la aplicación y 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
Heredan: QObject

Funciones públicas

QAxScriptManager(QObject *parent = nullptr)
virtual ~QAxScriptManager() override
void addObject(QAxBase *object)
void addObject(QObject *object)
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 = QAxScript::FunctionNames) const
QAxScript *load(const QString &code, const QString &name, const QString &language)
QAxScript *load(const QString &file, const QString &name)
QAxScript *script(const QString &name) const
QStringList scriptNames() const

Señales

void error(QAxScript *script, int code, const QString &description, int sourcePosition, const QString &sourceText)

Miembros públicos estáticos

bool registerEngine(const QString &name, const QString &extension, const QString &code = QString())
QString scriptFileFilter()

Descripción detallada

QAxScriptManager actúa como puente entre los objetos COM integrados en la aplicación Qt mediante QAxObject o QAxWidget, y los lenguajes de scripting disponibles a través de las tecnologías de scripts de Windows, normalmente JScript y VBScript.

Crea un QAxScriptManager para cada documento independiente de tu aplicación y añade los objetos COM a los que los scripts necesitan acceder mediante ` addObject()`. A continuación, carga las fuentes de los scripts con ` load()` e invoca las funciones mediante ` call()`.

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

Véase también QAxScript, QAxScriptEngine, QAxBase y ActiveQt Framework.

Documentación de las funciones miembro

[explicit] QAxScriptManager::QAxScriptManager(QObject *parent = nullptr)

Crea un objeto QAxScriptManager. Se pasa ` parent ` al constructor ` QObject `.

Lo habitual es crear un QAxScriptManager por cada documento de una aplicación.

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

Destruye los objetos y libera todos los recursos asignados.

void QAxScriptManager::addObject(QAxBase *object)

Añade « object » al gestor. Los scripts gestionados por este gestor pueden acceder al objeto en el código mediante la propiedad « objectName » del objeto.

Debes añadir todos los objetos necesarios antes de cargar cualquier script.

void QAxScriptManager::addObject(QObject *object)

Añade al gestor un envoltorio COM genérico para object. object debe exponerse como un objeto COM utilizando la funcionalidad que proporciona el módulo QAxServer. Las aplicaciones que utilicen esta función deben vincularse a la biblioteca qaxserver.

Se trata de una función sobrecargada.

QVariant QAxScriptManager::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 objeto ` QVariant ` no válido si la función no devuelve ningún valor o si la llamada a la función ha fallado. La llamada finaliza cuando termina la ejecución del script.

En la mayoría de los motores de scripts, el único tipo de parámetro admitido es «const QVariant&»; por ejemplo, para llamar a una función de JavaScript

function setNumber(number)
{
    n = number;
}

utiliza

QValueList args;
args << 5;
script->call("setNumber(const QVariant&)", args);

Al igual que con dynamicCall, los parámetros se pueden incrustar directamente en la cadena de la función.

script->call("setNumber(5)");

Sin embargo, esto es más lento.

Las funciones proporcionadas por motores de script que no admiten introspección no están disponibles y deben invocarse directamente utilizando ` QAxScript::call()` en el objeto ` script ` correspondiente.

Ten en cuenta que llamar a esta función puede ser significativamente más lento que utilizar call() directamente sobre el respectivo QAxScript.

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

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

Esta es una función sobrecargada.

[signal] void QAxScriptManager::error(QAxScript *script, 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 script.

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

Advertencia: No elimines script en una ranura conectada a esta señal. Utiliza en su lugar deleteLater().

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

Devuelve una lista con todas las funciones disponibles. Las funciones proporcionadas por motores de script que no admiten introspección no se incluyen en la lista. Las funciones se proporcionan con prototipos completos o solo como nombres, dependiendo del valor de ` flags`.

QAxScript *QAxScriptManager::load(const QString &code, const QString &name, const QString &language)

Carga el código fuente del script code utilizando el motor de scripts de language. Posteriormente, se puede acceder al script mediante su name, que no debe estar vacío.

La función devuelve un puntero al script para el code dado si el code se ha cargado correctamente; de lo contrario, devuelve 0.

Si language está vacío, 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 motores de script adicionales mediante registerEngine().

Debes añadir todos los objetos necesarios (utilizando addObject()) antes de cargar cualquier script. Si code declara una función que ya está disponible (independientemente del lenguaje), la primera función se sobrecarga y ya no se puede llamar mediante call(); sin embargo, seguirá estando disponible llamando directamente a su script.

Véase también addObject(), scriptNames() y functions().

QAxScript *QAxScriptManager::load(const QString &file, const QString &name)

Carga el código fuente desde file. Posteriormente, se puede acceder al script mediante su name, que no debe estar vacío.

La función devuelve un puntero al motor de scripts para el código de file si file se ha cargado correctamente; de lo contrario, devuelve 0.

El motor de scripts utilizado se determina a partir de la extensión del archivo. Por defecto, los archivos «.js» se interpretan como archivos JScript, y los archivos «.vbs» y «.dsm» se interpretan como VBScript. Se pueden registrar motores de scripts adicionales mediante registerEngine().

Esta es una función sobrecargada.

[static] bool QAxScriptManager::registerEngine(const QString &name, const QString &extension, const QString &code = QString())

Registra el motor de scripts denominado « name » y devuelve «true» si se ha encontrado el motor; en caso contrario, no realiza ninguna acción y devuelve «false».

El motor de scripts se utilizará al cargar archivos con el extension especificado, o al cargar código fuente que contenga la cadena code.

QAxScript *QAxScriptManager::script(const QString &name) const

Devuelve el script denominado « name ».

Puedes utilizar el puntero devuelto para llamar a funciones directamente a través de ` QAxScript::call()`, para acceder directamente al motor de scripts o para eliminar y, por lo tanto, descargar el script.

[static] QString QAxScriptManager::scriptFileFilter()

Devuelve un filtro de archivos que enumera todos los lenguajes de script compatibles. Esta cadena de filtro resulta muy útil para utilizarla con QFileDialog.

QStringList QAxScriptManager::scriptNames() const

Devuelve una lista con los nombres de todos los scripts.

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