Материал из Wiki.crossplatform.ru

Внимание: Актуальная версия перевода документации находится здесь

__NOTOC__

[править] QAxScriptManager Class Reference
^{[ QAxContainer module]}

The QAxScriptManager class provides a bridge between application objects and script code. Далее...

 #include <QAxScriptManager>

Inherits QObject.

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

[править] Открытые функции

• QAxScriptManager ( QObject * parent = 0 )
• ~QAxScriptManager ()
• 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

• 29 открытых функций, унаследованных от QObject

[править] Сигналы

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

• 1 сигнал, унаследованный от QObject

[править] Статические открытые члены

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

• 5 статических открытых членов, унаследованных от QObject

[править] Дополнительные унаследованные члены

• 1 свойство, унаследованное от QObject
• 1 открытый слот, унаследованный от QObject
• 7 защищенных функций, унаследованных от QObject

[править] Подробное описание

The QAxScriptManager class provides a bridge between application objects and script code.

The QAxScriptManager acts as a bridge between the COM objects embedded in the Qt application through QAxObject or QAxWidget, and the scripting languages available through the Windows Script technologies, usually JScript and VBScript.

Create one QAxScriptManager for each separate document in your application, and add the COM objects the scripts need to access using addObject(). Then load() the script sources and invoke the functions using call().

Warning: This class is not available with the bcc5.5 and MingW compilers.

See also QAxScript, QAxScriptEngine, QAxBase, and ActiveQt Framework.

[править] Описание функций-членов

[править]

QAxScriptManager::QAxScriptManager ( QObject * parent = 0 )

Creates a QAxScriptManager object. parent is passed on to the QObject constructor.

It is usual to create one QAxScriptManager for each document in an application.

[править]

QAxScriptManager::~QAxScriptManager ()

Destroys the objects, releasing all allocated resources.

[править]

void QAxScriptManager::addObject ( QAxBase * object )

Adds object to the manager. Scripts handled by this manager can access the object in the code using the object's objectName property.

You must add all the necessary objects before loading any scripts.

[править]

void QAxScriptManager::addObject ( QObject * object )

Эта перегруженная функция предоставлена для удобства.

Adds a generic COM wrapper for object to the manager. object must be exposed as a COM object using the functionality provided by the QAxServer module. Applications using this function you must link against the qaxserver library.

[править]

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

Calls function, passing the parameters var1, var1, var2, var3, var4, var5, var6, var7 and var8 as arguments and returns the value returned by the function, or an invalid QVariant if the function does not return a value or when the function call failed. The call returns when the script's execution has finished.

In most script engines the only supported parameter type is "const QVariant&", for example, to call a JavaScript function

 function setNumber(number)
 {
     n = number;
 }

use

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

As with dynamicCall the parameters can directly be embedded in the function string.

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

However, this is slower.

Functions provided by script engines that don't support introspection are not available and must be called directly using QAxScript::call() on the respective script object.

Note that calling this function can be significantely slower than using call() on the respective QAxScript directly.

[править]

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

Эта перегруженная функция предоставлена для удобства.

Calls function passing arguments as parameters, and returns the result. Returns when the script's execution has finished.

[править]

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

This signal is emitted when an execution error occurred while running script.

code, description, sourcePosition and sourceText contain information about the execution error.

Warning: Do not delete script in a slot connected to this signal. Use deleteLater() instead.

[править]

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

Returns a list with all the functions that are available. Functions provided by script engines that don't support introspection are not included in the list. The functions are either provided with full prototypes or only as names, depending on the value of flags.

[править]

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

Loads the script source code using the script engine for language. The script can later be referred to using its name which should not be empty.

The function returns a pointer to the script for the given code if the code was loaded successfully; otherwise it returns 0.

If language is empty it will be determined heuristically. If code contains the string "End Sub" it will be interpreted as VBScript, otherwise as JScript. Additional script engines can be registered using registerEngine().

You must add all the objects necessary (using addObject()) before loading any scripts. If code declares a function that is already available (no matter in which language) the first function is overloaded and can no longer be called via call(); but it will still be available by calling its script directly.

See also addObject(), scriptNames(), and functions().

[править]

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

Эта перегруженная функция предоставлена для удобства.

Loads the source code from the file. The script can later be referred to using its name which should not be empty.

The function returns a pointer to the script engine for the code in file if file was loaded successfully; otherwise it returns 0.

The script engine used is determined from the file's extension. By default ".js" files are interpreted as JScript files, and ".vbs" and ".dsm" files are interpreted as VBScript. Additional script engines can be registered using registerEngine().

[править]

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

Registers the script engine called name and returns true if the engine was found; otherwise does nothing and returns false.

The script engine will be used when loading files with the given extension, or when loading source code that contains the string code.

[править]

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

Returns the script called name.

You can use the returned pointer to call functions directly through QAxScript::call(), to access the script engine directly, or to delete and thus unload the script.

[править]

QString QAxScriptManager::scriptFileFilter () [static]

Returns a file filter listing all the supported script languages. This filter string is convenient for use with QFileDialog.

[править]

QStringList QAxScriptManager::scriptNames () const

Returns a list with the names of all the scripts.