DO NOT EDIT THE CONTENT OF THIS PAGE DIRECTLY (EXCEPT INSIDE THE DIV BELOW WITH ID=DESCRIPTION), UNLESS YOU KNOW WHAT YOU'RE DOING.
THE STRUCTURE OF THE CONTENT IS VITAL IN BEING ABLE TO AUTO UPDATE THE CONTENT THROUGH THE DOC GENERATOR.

Enter additional information related to this 'class' inside the {div} macro with 'id=description'



Constants Summary
String
ACTION
Constant returned by JSEvent.
String
DATACHANGE
Constant returned by JSEvent.
String
DOUBLECLICK
Constant returned by JSEvent.
String
FOCUSGAINED
Constant returned by JSEvent.
String
FOCUSLOST
Constant returned by JSEvent.
String
FORM
Constant returned by JSEvent.
Number
MODIFIER_ALT
Constant for the ALT modifier that can be returned by JSEvent.
Number
MODIFIER_CTRL
Constant for the CTRL modifier that can be returned by JSEvent.
Number
MODIFIER_META
Constant for the META modifier that can be returned by JSEvent.
Number
MODIFIER_SHIFT
Constant for the SHIFT modifier that can be returned by JSEvent.
String
NONE
Constant returned by JSEvent.
String
RIGHTCLICK
Constant returned by JSEvent.



Property Summary
Object
data
A data object that specific events can set, a user can set data back to the system for events that supports this.



Method Summary
String
getElementName()
returns the name of the element, can be null if the form was the source of the event.
String
getFormName()
returns the name of the form the element was placed on.
Number
getModifiers()
Returns the modifiers of the event, see JSEvent.
Object
getSource()
returns the source component/element of the event.
Date
getTimestamp()
Returns the time the event occurred.
String
getType()
returns the event type see the JSEvents constants what it can return.
Number
getX()
Returns the x position of the event, relative to the component that fired it, if applicable.
Number
getY()
Returns the y position of the event, relative to the component that fired it, if applicable.



Constants Details

ACTION

Constant returned by JSEvent.getType() in a method that is attached to an onAction event.

Returns

String

Sample

if (event.getType() == JSEvent.ACTION)
{
	// its an action event.
}
 

DATACHANGE

Constant returned by JSEvent.getType() in a method that is attached to an onDataChange event.

Returns

String

Sample

if (event.getType() == JSEvent.DATACHANGE)
{
	// its a data change event
}
 

DOUBLECLICK

Constant returned by JSEvent.getType() in a method that is attached to an onDoubleClick event.

Returns

String

Sample

if (event.getType() == JSEvent.DOUBLECLICK)
{
	// its a double click event.
}
 

FOCUSGAINED

Constant returned by JSEvent.getType() in a method that is attached to an onFocusGained or the forms onElementFocusGained event.

Returns

String

Sample

if (event.getType() == JSEvent.FOCUSGAINED)
{
	// its a focus gained event.
}
 

FOCUSLOST

Constant returned by JSEvent.getType() in a method that is attached to an onFocusLost or the forms onElementFocusLost event.

Returns

String

Sample

if (event.getType() == JSEvent.FOCUSLOST)
{
	// its a focus lost event.
}
 

FORM

Constant returned by JSEvent.getType() in a method that is attached to a form event (like onShow) or command (like onDeleteRecord)

Returns

String

Sample

if (event.getType() == JSEvent.FORM)
{
	// its a form event or command
}
 

MODIFIER_ALT

Constant for the ALT modifier that can be returned by JSEvent.getModifiers();

Returns

Number

Sample

//test if the SHIFT modifier is used.
if (event.getModifiers() & JSEvent.MODIFIER_SHIFT)
{
	//do shift action
}
 

MODIFIER_CTRL

Constant for the CTRL modifier that can be returned by JSEvent.getModifiers();

Returns

Number

Sample

//test if the SHIFT modifier is used.
if (event.getModifiers() & JSEvent.MODIFIER_SHIFT)
{
	//do shift action
}
 

MODIFIER_META

Constant for the META modifier that can be returned by JSEvent.getModifiers();

Returns

Number

Sample

//test if the SHIFT modifier is used.
if (event.getModifiers() & JSEvent.MODIFIER_SHIFT)
{
	//do shift action
}
 

MODIFIER_SHIFT

Constant for the SHIFT modifier that can be returned by JSEvent.getModifiers();

Returns

Number

Sample

//test if the SHIFT modifier is used.
if (event.getModifiers() & JSEvent.MODIFIER_SHIFT)
{
	//do shift action
}
 

NONE

Constant returned by JSEvent.getType() if the event is not used in a known event or command.

Returns

String

Sample

if (event.getType() == JSEvent.NONE)
{
	// type is not set.
}
 

RIGHTCLICK

Constant returned by JSEvent.getType() in a method that is attached to an onRightClick event.

Returns

String

Sample

if (event.getType() == JSEvent.RIGHTCLICK)
{
	// its a right click event.
}
 



Property Details

data

A data object that specific events can set, a user can set data back to the system for events that supports this.

Returns

Object

Sample

// A client design method that handles ondrag
if (event.getType() == JSEvent.ONDRAG)
{
     // the data is the selected elements array
     var elements = event.data;
     // only start a client design drag when there is 1 element
     if (elements.length == 1)
     {
     	return true;
     }
}

// code for a data drag method
event.data = "drag me!";
return DRAGNDROP.COPY;

// code for a data drop method
var data = event.data;
elemements[event.getElementName()].setText(data);
return true;
 



Method Details

getElementName

String
getElementName
()
returns the name of the element, can be null if the form was the source of the event.

Returns

String - a String representing the element name.

Sample

if (event.getElementName() == 'myElement')
{
    elements[event.getElementName()].bgcolor = '#ff0000';
}
 

getFormName

String
getFormName
()
returns the name of the form the element was placed on.

Returns

String - a String representing the form name.

Sample

forms[event.getFormName()].myFormMethod();
 

getModifiers

Number
getModifiers
()
Returns the modifiers of the event, see JSEvent.MODIFIER_XXXX for the modifiers that can be returned.

Returns

Number - an int which holds the modifiers as a bitset.

Sample

//test if the SHIFT modifier is used.
if (event.getModifiers() & JSEvent.MODIFIER_SHIFT)
{
	//do shift action
}
 

getSource

Object
getSource
()
returns the source component/element of the event.
If it has a name the getElementName() is the name of this component.

Returns

Object - an Object representing the source of this event.

Sample

// cast to runtime text field (change to anoter kind of type if you know the type)
/** @type {RuntimeTextField} */
var source = event.getSource();
var sourceDataProvider = source.getDataProviderID();
 

getTimestamp

Date
getTimestamp
()
Returns the time the event occurred.

Returns

Date - a Date when this event happened.

Sample

event.getTimestamp();
 

getType

String
getType
()
returns the event type see the JSEvents constants what it can return.
Plugins can create events with there own types.

Returns

String - a String representing the type of this event.

Sample

if (event.getType() == JSEvent.ACTION)
{
	// its an action event.
}
 

getX

Number
getX
()
Returns the x position of the event, relative to the component that fired it, if applicable.
For example drag'n'drop events will set the x,y positions.

Returns

Number - an int representing the X position.

Sample

var x = event.getX();
var xPrevious = previousEvent.getX();
var movedXPixels = x -xPrevious;
 

getY

Number
getY
()
Returns the y position of the event, relative to the component that fired it, if applicable.
For example drag'n'drop events will set the x,y positions.

Returns

Number - an int representing the Y position.

Sample

var y = event.getY();
var yPrevious = previousEvent.getY();
var movedYPixels = y -yPrevious;