Changes between Version 5 and Version 6 of QtScript

Timestamp:

Aug 18, 2010 6:03:06 AM (14 years ago)

Author:

kent.hansen@nokia.com

Comment:

--

QtScript

@@ -248 +248 @@
 
 It's possible to override QtScript's conversion of any type by registering a pair of conversion functions for the type using qScriptRegisterMetaType().
+
+=== Mapping Qt Classes to JavaScript ===
+
+Qt's introspection capabilities can be used to set up a JS inheritance chain that corresponds to the C++ inheritance.
+
+   * QMetaObject::superClass() provides the meta-object of a class's super class.
+   * QMetaObject::propertyOffset() provides the offset of a class's own properties. QMetaObject::propertyCount() - QMetaObject::propertyOffset() gives the number of properties defined by the class itself (i.e. not including inherited properties).
+   * QMetaObject::methodOffset() provides the offset of a class's own methods. QMetaObject::methodCount() - QMetaObject::methodOffset() gives the number of methods defined by the class itself (i.e. not including inherited methods).
+
+The idea is to define a JS class (JSClassCreate() and friends in the JSC C API) that defines the class's own properties (corresponding to C++ properties), and that inherits the JS super-class. Each JS class also has a prototype object that contains the class's own methods (corresponding to C++ methods).
+
+Example: QPushButton; see http://doc.trolltech.com/4.6/qpushbutton.html. (This would probably work better as a diagram:)
+
+   * JSClass(QPushButton).properties = autoDefault, default, flat
+   * JSPrototype(QPushButton).properties = showMenu
+   * JSPrototype(QPushButton).__proto__ = JSPrototype(QAbstractButton)
+   * JSClass(QPushButton).superClass = JSClass(QAbstractButton)
+
+   * JSClass(QAbstractButton).properties = autoExclusive, autoRepeat, ...
+   * JSPrototype(QAbstractButton).properties = animateClick, click, setChecked, setIconSize, toggle
+   * JSPrototype(QAbstractButton).__proto__ = JSPrototype(QWidget)
+   * JSClass(QAbstractButton).superClass = JSClass(QWidget)
+
+... and so on, all the way down to QObject.
+
+These class definitions and prototype objects can be created on demand, and cached so that they can be shared by all wrapped objects of the same type.