Класс QAxScriptManager

Класс QAxScriptManager обеспечивает связь между объектами приложения и скриптовым кодом. Подробнее...

• Список всех членов, включая унаследованные

Открытые функции

Сигналы

Статические открытые члены

Подробное описание

QAxScriptManager действует как мост между объектами COM, встроенными в приложение Qt через QAxObject или QAxWidget, и скриптовыми языками, доступными через технологии сценариев Windows, обычно JScript и VBScript.

Создавайте один QAxScriptManager для каждого отдельного документа в вашем приложении и добавляйте необходимые объекты COM, к которым должны иметь доступ скрипты, используя addObject(). Затем загружайте исходные коды скриптов с помощью load() и вызывайте функции с помощью call().

Предупреждение: Этот класс недоступен с компилятором bcc5.5.

См. также QAxScript, QAxScriptEngine, QAxBase и Фреймворк ActiveQt.

Документация по функциям-членам

QAxScriptManager::QAxScriptManager(QObject *parent = nullptr)

Создаёт объект QAxScriptManager. parent передаётся конструктору QObject.

Обычно создаётся один QAxScriptManager для каждого документа в приложении.

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

Этот сигнал излучается, когда произошла ошибка выполнения при запуске script.

code, description, sourcePosition и sourceText содержат информацию об ошибке выполнения.

Предупреждение: Не удаляйте script в слоте, подключённом к этому сигналу. Используйте deleteLater() вместо этого.

[override virtual] QAxScriptManager::~QAxScriptManager()

Удаляет объекты, освобождая все выделенные ресурсы.

void QAxScriptManager::addObject(QAxBase *object)

Добавляет object в менеджер. Скрипты, обрабатываемые этим менеджером, могут получить доступ к объекту, используя свойство objectName объекта.

Вы должны добавить все необходимые объекты перед загрузкой каких-либо скриптов.

void QAxScriptManager::addObject(QObject *object)

Это перегруженная функция.

Добавляет оболочку COM для object в менеджер. object должен быть экспонирован как объект COM с помощью функциональности модуля QAxServer. Приложения, использующие эту функцию, должны быть связаны с библиотекой qaxserver.

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())

Вызывает function, передавая параметры var1, var1, var2, var3, var4, var5, var6, var7 и var8 в качестве аргументов и возвращает значение, возвращённое функцией, или недействительную QVariant, если функция не возвращает значение или вызов функции завершился с ошибкой. Вызов возвращается, когда выполнение скрипта завершается.

В большинстве скриптовых движков единственный поддерживаемый тип параметра — "const QVariant&", например, для вызова JavaScript-функции

function setNumber(number)
{
    n = number;
}

используйте

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

Как и в dynamicCall, параметры можно напрямую встроить в строку функции.

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

Однако это медленнее.

Функции, предоставляемые скриптовыми движками, которые не поддерживают интроспекцию, недоступны и должны вызываться напрямую с помощью QAxScript::call() на соответствующем объекте script.

Обратите внимание, что вызов этой функции может быть значительно медленнее, чем использование call() на соответствующем объекте QAxScript напрямую.

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

Это перегруженная функция.

Вызывает function, передавая arguments в качестве параметров, и возвращает результат. Возвращается, когда выполнение скрипта завершается.

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

Возвращает список всех доступных функций. Функции, предоставляемые скриптовыми движками, которые не поддерживают интроспекцию, не включаются в список. Функции предоставляются либо с полными прототипами, либо только в виде имён, в зависимости от значения flags.

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

Загружает исходный код скрипта code с помощью движка скриптов для language. К скрипту в дальнейшем можно обратиться по его имени name, которое не должно быть пустым.

Функция возвращает указатель на скрипт для данного кода, если код был загружен успешно; в противном случае возвращает 0.

Если язык пустой, он будет определен эвристически. Если код содержит строку "End Sub", он будет интерпретирован как VBScript, в противном случае как JScript. Дополнительные движки скриптов могут быть зарегистрированы с помощью registerEngine().

Вы должны добавить все необходимые объекты (используя addObject()) перед загрузкой каких-либо скриптов. Если код объявляет функцию, которая уже доступна (независимо от языка), первая функция перегружается и больше не может быть вызвана через call(); но она всё ещё будет доступна, вызвав её через script напрямую.

См. также addObject(), scriptNames(), и functions().

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

Это перегруженная функция.

Загружает исходный код из файла file. Скрипт впоследствии может быть вызван по его имени, которое не должно быть пустым.

Функция возвращает указатель на движок скриптов для кода в file, если file был загружен успешно; в противном случае возвращает 0.

Используемый движок скриптов определяется из расширения файла. По умолчанию файлы ".js" интерпретируются как JScript файлы, а ".vbs" и ".dsm" - как VBScript. Дополнительные движки скриптов могут быть зарегистрированы с помощью registerEngine().

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

Регистрирует движок скриптов под именем name и возвращает true, если движок был найден; в противном случае ничего не делает и возвращает false.

Движок скриптов будет использоваться при загрузке файлов с заданным расширением или при загрузке исходного кода, содержащего строку code.

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

Возвращает скрипт под названием name.

Вы можете использовать возвращённый указатель для непосредственного вызова функций через QAxScript::call(), для прямого доступа к движку скриптов или для удаления и, следовательно, разгрузки скрипта.

[static] QString QAxScriptManager::scriptFileFilter()

Возвращает фильтр файлов, перечисляющий все поддерживаемые языки скриптов. Эта строка фильтра удобна для использования с QFileDialog.

QStringList QAxScriptManager::scriptNames() const

Возвращает список с именами всех скриптов.