KJSEmbed Types

Introduction

KJSEmbed adds a number of custom types to those defined by ECMA in addition to the objects themselves. These types are used to pass complex datatypes between scripts and the C++ code that is hosting the script. This document describes the representations used to pass information in each direction.

It should be noted that currently only a single representation is available to scripts accessing native types. Scripts should not rely on this behaviour as the restriction may be removed in a future release of KJSEmbed so this, though the current script API will continue to be supported.

Fundamental Types

Numbers

int -> Number
uint -> Number
float -> Number
double -> Number
Number -> int
Number -> uint
Number -> float
Number -> double

Strings

TQString -> String
TQCString -> String
const char * -> String
String -> QString
String -> QCString
String -> const char *

Qt Object Types

TQColor

Represents a color, possibly including an alpha channel.

TQColor -> '#rrggbb'
'#rrggbb' -> QColor
'#rrggbbaa' -> QColor

TQPoint

Represents a point.

TQPoint -> [x,y]
[x,y] -> QPoint
obj.x obj.y -> QPoint

TQSize

Represents a size.

TQSize -> [w,h]
[w,h] -> QSize
obj.w obj.h -> QSize

TQRect

Represents a rectangle.

TQRect -> [x,y,w,h]
[x,y,w,h] -> QRect
obj.x obj.y obj.w obj.h -> QRect

TQDate

Represents a date.

TQDate -> ''

TQTime

Represents a time.

TQTime -> ''

TQDateTime

Represents a date/time pair.

TQDateTime -> ''

TQKeySequence

Represents a sequence of keys, eg. it is used for accelerators.

TQKeySequence -> ''

TQFont

Represents a font.

TQFont -> ''

KDE Object Types

KURL

Represents a URL.

KURL -> ''
'' -> KURL