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

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

__NOTOC__

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

The QAxScript class provides a wrapper around script code. Далее...

 #include <QAxScript>

Inherits QObject.

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

[править] Открытые типы

• enum FunctionFlags { FunctionNames, FunctionSignatures }

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

• QAxScript ( const QString & name, QAxScriptManager * manager )
• ~QAxScript ()
• 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 ( FunctionFlags flags = FunctionNames ) const
• bool load ( const QString & code, const QString & language = QString() )
• QString scriptCode () const
• QAxScriptEngine * scriptEngine () const
• QString scriptName () const

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

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

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

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

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

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

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

The QAxScript class provides a wrapper around script code.

Every instance of the QAxScript class represents a piece of scripting code in a particular scripting language. The code is loaded into the script engine using load(). Functions declared in the code can be called using call().

The script provides scriptEngine() provides feedback to the application through signals. The most important signal is the error() signal. Direct access to the QAxScriptEngine is provided through the scriptEngine() function.

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

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

[править] Описание типов

[править]

enum QAxScript::FunctionFlags

This FunctionFlags enum describes formatting for function introspection.

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

[править]

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

Constructs a QAxScript object called name and registers it with the QAxScriptManager manager. This is usually done by the QAxScriptManager class when loading a script.

A script should always have a name. A manager is necessary to allow the script code to reference objects in the application. The manager takes ownership of the object.

[править]

QAxScript::~QAxScript ()

Destroys the object, releasing all allocated resources.

[править]

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

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.

See QAxScriptManager::call() for more information about how to call script functions.

[править]

QVariant QAxScript::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.

See QAxScriptManager::call() for more information about how to call script functions.

[править]

void QAxScript::entered () [signal]

This signal is emitted when a script engine has started executing code.

[править]

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

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

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

[править]

void QAxScript::finished () [signal]

This signal is emitted when a script engine has finished executing code.

[править]

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

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

result contains the script's result. This will be an invalid QVariant if the script has no return value.

[править]

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

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

code, source, description and help contain exception information when the script terminated.

[править]

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

Returns a list of all the functions in this script if the respective script engine supports introspection; otherwise returns an empty list. The functions are either provided with full prototypes or only as names, depending on the value of flags.

See also QAxScriptEngine::hasIntrospection().

[править]

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

Loads the script source code written in language language into the script engine. Returns true if code was successfully entered into the script engine; otherwise returns false.

If language is empty (the default) it will be determined heuristically. If code contains the string End Sub it will be interpreted as VBScript, otherwise as JScript. Additional scripting languages can be registered using QAxScript::registerEngine().

This function can only be called once for each QAxScript object, which is done automatically when using QAxScriptManager::load().

[править]

QString QAxScript::scriptCode () const

Returns the script's code, or the null-string if no code has been loaded yet.

See also load().

[править]

QAxScriptEngine * QAxScript::scriptEngine () const

Returns a pointer to the script engine.

You can use the object returned to connect signals to the script functions, or to access the script engine directly.

[править]

QString QAxScript::scriptName () const

Returns the name of the script.

[править]

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

This signal is emitted when a script engine changes state. state can be any value in the QAxScriptEngineState enumeration.