Wt::WJavaScriptExposableObject Class Reference

A JavaScript exposable object. More...

#include <Wt/WJavaScriptExposableObject.h>

Inheritance diagram for Wt::WJavaScriptExposableObject:

Public Member Functions
bool	isJavaScriptBound () const
	Returns whether this object is JavaScript bound. More...
virtual std::string	jsValue () const =0
	Returns a JavaScript representation of the value of this object. More...
std::string	jsRef () const
	Returns a JavaScript reference to this object. More...

Detailed Description

A JavaScript exposable object.

A JavaScript bound object (as opposed to being mostly a simple value class) has an equivalent representation in JavaScript. Its value can usually only be modified through a WJavaScriptHandle. There are certain exceptions to this rule. Some methods, notably many WTransform methods, will correctly apply these modifications also on the JavaScript representation.

See also

WJavaScriptHandle

Member Function Documentation

isJavaScriptBound()

bool Wt::WJavaScriptExposableObject::isJavaScriptBound

(

)

const

Returns whether this object is JavaScript bound.

An object is JavaScript bound if it is associated with a WJavaScriptHandle. It should not be modified directly on the server side. WJavaScriptHandle::setValue() should be used instead.

jsRef()

std::string Wt::WJavaScriptExposableObject::jsRef

(

)

const

Returns a JavaScript reference to this object.

If this object is not JavaScript bound, it will return a JavaScript representation of the value of the object, according to jsValue().

Warning

This reference is intended as read-only. Attempts to modify it may have unintended consequences. If you want a JavaScript reference that is modifiable, use the jsRef of the handle instead.

jsValue()

virtual std::string Wt::WJavaScriptExposableObject::jsValue ( ) const

pure virtual

Returns a JavaScript representation of the value of this object.

Note

The value returned will reflect the current server side value of the object. If this object is JavaScript bound, this value may not reflect the actual client side value. If you need access to the client side value, use jsRef() intead.

Implemented in Wt::WTransform, Wt::WRectF, Wt::WPointF, Wt::WPen, Wt::WPainterPath, and Wt::WBrush.