Wt  3.3.9
Public Member Functions | List of all members
Wt::WJavaScriptExposableObject Class Referenceabstract

A JavaScript exposable object. More...

#include <Wt/WJavaScriptExposableObject>

Inheritance diagram for Wt::WJavaScriptExposableObject:
Inheritance graph
[legend]

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

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.

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.
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::WPainterPath, Wt::WTransform, Wt::WRectF, Wt::WPen, Wt::WBrush, and Wt::WPointF.


Generated on Tue Nov 21 2017 for the C++ Web Toolkit (Wt) by doxygen 1.8.11