Home · All Classes · Modules  · QSS HELP  · QSS 案例 · VER007 HOME

QScriptClass Class Reference
^{[QtScript module]}

该QScriptClass类提供用于定义（一类）的Qt Script对象的自定义行为的接口。More...

Types

• enum Extension { Callable, HasInstance }
• enum QueryFlag { HandlesReadAccess, HandlesWriteAccess }
• class QueryFlags

Methods

• __init__ (self, QScriptEngine engine)
• QScriptEngine engine (self)
• QVariant extension (self, Extension extension, QVariant argument = QVariant())
• QString name (self)
• QScriptClassPropertyIterator newIterator (self, QScriptValue object)
• QScriptValue property (self, QScriptValue object, QScriptString name, int id)
• QScriptValue.PropertyFlags propertyFlags (self, QScriptValue object, QScriptString name, int id)
• QScriptValue prototype (self)
• (QueryFlags, int id) queryProperty (self, QScriptValue object, QScriptString name, QueryFlags flags)
• setProperty (self, QScriptValue object, QScriptString name, int id, QScriptValue value)
• bool supportsExtension (self, Extension extension)

Detailed Description

该QScriptClass类提供用于定义（一类）的Qt Script对象的自定义行为的接口。

该QScriptClass类定义用于处理交互的各个方面与类相关的Qt的脚本对象的接口。这些对象通过调用创建QScriptEngine.newObject（ ） ，传递一个指针QScriptClass作为参数。

通过子类QScriptClass ，您可以精确地定义了如何访问使用你的类的对象的属性进行处理。这使得属性的完全动态处理，例如：它比功能更强大QScriptEngine.newQObject（ ） 。例如，您可以使用QScriptClass实现数组类型的对象（即处理的对象length属性和属性的名称是有效的数组索引，以特殊的方式） ，或者为了实现一个“活” （运行时定义的）的代理到底层对象。

如果你只需要处理访问一组已知在创建一个对象的时间属性（即“半静态” ） ，你可能会考虑使用QScriptValue.setProperty（ ）来定义的getter / setter函数的相关性，而不是继承QScriptClass 。

重新实现queryProperty（）来指定哪些属性在自定义的方式通过你的脚本类处理（即应delegated到QScriptClass ） ，以及哪些属性应该就像正常的Qt Script对象的属性进行处理。

重新实现property（）和setProperty（ ）来执行实际的访问（读或写）到您的类处理性能。此外，您可以重新实现propertyFlags（）来指定自定义标记为您的物业。

重新实现newIterator（ ）提供一个迭代器为自定义类的对象。这仅仅是必要的，如果你的类的对象可以有你想要当一个对象被一起用来报告自定义属性QScriptValueIterator类，或者当一个对象被用在换在枚举声明中的脚本。

当实现对象的自定义类，通常使用QScriptValue.setData（ ）来存储特定于实例的数据作为对象初始化的一部分，该数据将无法从脚本直接访问，但您可以访问它，例如在您的重新实现property（）和setProperty（ ） （通过调用QScriptValue.data（））来执行自定义处理。

重新实现prototype（）为您的脚本类提供自定义的原型对象。

重新实现supportsExtension（）和extension（ ）如果你的自定义脚本类支持一个由扩展枚举指定的扩展名或更多。

Type Documentation

QScriptClass.Extension

这个枚举指定可能的扩展到QScriptClass。

See also extension（ ） 。

QScriptClass.QueryFlag

这个枚举变量描述了用于查询标志QScriptClass关于如何获得一个属性的处理方式。

该QueryFlags类型是一个typedef为QFlags\u003cQueryFlag\u003e 。它存储QueryFlag值的或组合。

See also queryProperty（ ） 。

Method Documentation

QScriptClass.__init__ (self, QScriptEngine engine)

构造一个QScriptClass对象在给定的被使用engine。

发动机不走的所有权QScriptClass对象。

QScriptEngine QScriptClass.engine (self)

返回发动机，这QScriptClass相关联。

QVariant QScriptClass.extension (self, Extension extension, QVariant argument = QVariant())

这个虚函数可以在重新实现QScriptClass子类以提供扩展的支持。可选的argument可以作为输入提供给extension;结果必须在一个形式被返回QVariant。您可以致电supportsExtension（ ）来检查一个扩展是支持的QScriptClass。默认情况下，没有扩展名的支持，这个函数返回一个无效QVariant。

如果实现的可赎回扩展， Qt的脚本会调用这个函数时，你的类的一个实例作为函数调用（例如，从一个脚本或使用QScriptValue.call（））。该argument将包含一个指针，指向QScriptContext表示函数调用，你应该返回一个QVariant保存函数调用的结果。在下面的示例中的参数传递给脚本函数的总和相加并返回：

 if (extension == Callable) {
     QScriptContext *context = qvariant_cast<QScriptContext*>(argument);
     QScriptEngine *engine = context->engine();
     double sum = 0;
     for (int i = 0; i < context->argumentCount(); ++i)
         sum += context->argument(i).toNumber();
     return sum;
 }

如果实现HasInstance扩展， Qt的脚本会调用这个函数作为评估的一部分，instanceof操作者，如在ECMA-262第11.8.6说明。该argument是一个包含两个项目一个QScriptValueList ：第一项是对象HasInstance被应用到（你的类的一个实例） ，第二项可以是任何值。扩展（ ）应该返回True ，如果该值代表行为的对象，否则返回False。

See also supportsExtension（ ） 。

QString QScriptClass.name (self)

返回脚本类的名称。

Qt的脚本使用此名称来生成对象的情况下，你不提供一个toString函数的默认字符串表示形式。

默认实现返回一个空字符串。

QScriptClassPropertyIterator QScriptClass.newIterator (self, QScriptValue object)

返回一个迭代器遍历给定的自定义属性object。

默认实现返回0 ，这意味着没有任何自定义属性来遍历。

重新实现这个功能，如果你的脚本类的对象可以有一个或多个自定义属性（例如那些报导被处理queryProperty（ ） ），您要当一个对象的属性列举（例如，通过一个for in语句在脚本中）出现。

Qt的脚本需要新的迭代器对象的所有权。

See also QScriptValueIterator。

QScriptValue QScriptClass.property (self, QScriptValue object, QScriptString name, int id)

用给定的返回属性的值name的给定object。

该id如果你分配一个值给它的参数是唯一有用的queryProperty（ ） 。

默认实现不执行任何操作，并返回一个无效的QScriptValue。

See also setProperty（）和propertyFlags（ ） 。

QScriptValue.PropertyFlags QScriptClass.propertyFlags (self, QScriptValue object, QScriptString name, int id)

返回属性的标志与给定name的给定object。

该id如果你分配一个值给它的参数是唯一有用的queryProperty（ ） 。

默认实现返回0 。

See also property（ ） 。

QScriptValue QScriptClass.prototype (self)

返回要使用的对象作为这个类的新实例的原型（与创建QScriptEngine.newObject（））。

默认实现返回一个无效的QScriptValue的，这意味着标准的对象的原型将被使用。重新实现此功能提供您自己的自定义原型。

通常你初始化你的原型对象在类的构造函数，那么它在这个函数中返回。

请参阅“利用基于原型的继承”一节QtScript文档以获取有关如何原型使用的详细信息。

(QueryFlags, int id) QScriptClass.queryProperty (self, QScriptValue object, QScriptString name, QueryFlags flags)

查询如何用给定的访问属性这个脚本类name的给定object应该如何处理。给定flags指定感兴趣的方面。这个函数应该返回的一个子集flags来表示，其中属性访问方面应该由脚本类被进一步处理。

例如，如果flags包含HandlesReadAccess，你想你的类来处理该物业的读数（通过property（ ）函数） ，返回的标志应包括：HandlesReadAccess。如果返回的标志不包含HandlesReadAccess，该物业将作为一个正常的脚本对象属性来处理。

您可以选择使用id参数存储将随后被传递给函数，如值property（）和setProperty（ ） 。

此函数的默认实现返回0 。

注意：如果给定的属性是不是已经对对象的一个属性，此功能时，才调用。例如，假设你做广告，你要处理的读访问属性foo，但不能写入权限，如果foo然后被分配一个值，它会成为一个正常的脚本对象的属性，随后你将不再就到读访问查询foo。

See also property（ ） 。

QScriptClass.setProperty (self, QScriptValue object, QScriptString name, int id, QScriptValue value)

设置该属性与给定name的给定object为给定的value。

该id如果你分配一个值给它的参数是唯一有用的queryProperty（ ） 。

默认实现不执行任何操作。

无效的value表示请求移除该属性。

See also property（ ） 。

bool QScriptClass.supportsExtension (self, Extension extension)

返回True如果QScriptClass支持给定extension否则，则返回False。默认情况下，没有扩展名的支持。

重新实现这个功能，可显示哪些扩展您的自定义类的支持。

See also extension（ ） 。