Child pages
  • JSEvent

Versions Compared

Key

  • This line was added.
  • This line was removed.
  • Formatting was changed.
Comment: Rev: 1381949650879

...

HTML Table
id
classservoy sSummary
Colgroup Tag
Column
padding0px
width80px

Column

Table Row (tr)
styleheight: 30px;
Table Head (th)
colspan2
Constants Summary
Table Body (tbody)
Table Row (tr)
Table Cell (td)
String
Table Cell (td)
#ACTIONACTION
Constant returned by JSEvent.
Table Body (tbody)
Table Row (tr)
Table Cell (td)
String
Table Cell (td)
#DATACHANGEDATACHANGE
Constant returned by JSEvent.
tbody
Table Body (tbody)
Table Row (tr)
Table Cell (td)
String
Table Cell (td)
#DOUBLECLICKDOUBLECLICK
Constant returned by JSEvent.
Table Row (tr)
Table Cell (td)
String
Table Cell (td)
#FOCUSGAINEDFOCUSGAINED
Constant returned by JSEvent.
Table Body (tbody)
Table Row (tr)
Table Cell (td)
String
Table Cell (td)
#FOCUSLOSTFOCUSLOST
Constant returned by JSEvent.
Table Body (tbody)
tbody
Table Row (tr)
Table Cell (td)
String
Table Cell (td)
#FORMFORM
Constant returned by JSEvent.
Table Row (tr)
Table Cell (td)
Number
Table Cell (td)
#MODIFIERMODIFIER_ALT
Constant for the ALT modifier that can be returned by JSEvent.
Table Body (tbody)
Table Row (tr)
Table Cell (td)
Number
Table Cell (td)
#MODIFIERMODIFIER_CTRL
Constant for the CTRL modifier that can be returned by JSEvent.
tbody
Table Body (tbody)
Table Row (tr)
Table Cell (td)
Number
Table Cell (td)
#MODIFIERMODIFIER_META
Constant for the META modifier that can be returned by JSEvent.
Table Row (tr)
Table Cell (td)
Number
Table Cell (td)
#MODIFIERMODIFIER_SHIFT
Constant for the SHIFT modifier that can be returned by JSEvent.
tbody
Table Body (tbody)
Table Row (tr)
Table Cell (td)
String
Table Cell (td)
#NONENONE
Constant returned by JSEvent.
Table Row (tr)
Table Cell (td)
String
Table Cell (td)
#RIGHTCLICKRIGHTCLICK
Constant returned by JSEvent.

HTML Table
id
classservoy sSummary
Colgroup Tag
Column
padding0px
width80px

Column

Table Row (tr)
styleheight: 30px;
Table Head (th)
colspan2
Property Summary
Table Body (tbody)
Table Row (tr)
Table Cell (td)
Object
Table Cell (td)
#datadata
A data object that specific events can set, a user can set data back to the system for events that supports this.

HTML Table
id
classservoy sSummary
Colgroup Tag
Column
padding0px
width80px

Column

Table Row (tr)
styleheight: 30px;
Table Head (th)
colspan2
Method Summary
Table Body (tbody)
Table Row (tr)
Table Cell (td)
String
Table Cell (td)
#getElementNamegetElementName()
returns the name of the element, can be null if the form was the source of the event.
Table Body (tbody)
Table Row (tr)
Table Cell (td)
String
Table Cell (td)
#getFormNamegetFormName()
returns the name of the form the element was placed on.
tbody
Table Body (tbody)
Table Row (tr)
Table Cell (td)
Number
Table Cell (td)
#getModifiersgetModifiers()
Returns the modifiers of the event, see JSEvent.
Table Row (tr)
Table Cell (td)
Object
Table Cell (td)
#getSourcegetSource()
returns the source component/element of the event.
Table Body (tbody)
Table Row (tr)
Table Cell (td)
Date
Table Cell (td)
#getTimestampgetTimestamp()
Returns the time the event occurred.
Table Body (tbody)
Table Row (tr)
Table Cell (td)
String
Table Cell (td)
#getTypegetType()
returns the event type see the JSEvents constants what it can return.
tbody
Table Body (tbody)
Table Row (tr)
Table Cell (td)
Number
Table Cell (td)
#getXgetX()
Returns the x position of the event, relative to the component that fired it, if applicable.
Table Row (tr)
Table Cell (td)
Number
Table Cell (td)
#getYgetY()
Returns the y position of the event, relative to the component that fired it, if applicable.

HTML Table
idconstant
classservoy sDetail
Colgroup Tag
Column
padding0px
width100%

Table Row (tr)
styleheight: 30px;
Table Head (th)
colspan1
Constants Details
Table Body (tbody)
idACTION
Table Row (tr)
idname
Table Cell (td)
ACTION
Table Row (tr)
iddes
Table Cell (td)
Div
classsIndent
Constant returned by JSEvent.getType() in a method that is attached to an onAction event.
Table Row (tr)
idret
Table Cell (td)
Returns
Div
classsIndent
String
Table Row (tr)
idsam
Table Cell (td)
Sample
Div
classsIndent
Code Block
languagejavascript

if (event.getType() == JSEvent.ACTION) 
{
	// its an action event.
}
Table Row (tr)
classlastDetailRow
Table Cell (td)

Table Body (tbody)
idDATACHANGE
Table Row (tr)
idname
Table Cell (td)
DATACHANGE
Table Row (tr)
iddes
Table Cell (td)
Div
classsIndent
Constant returned by JSEvent.getType() in a method that is attached to an onDataChange event.
Table Row (tr)
idret
Table Cell (td)
Returns
Div
classsIndent
String
Table Row (tr)
idsam
Table Cell (td)
Sample
Div
classsIndent
Code Block
languagejavascript

if (event.getType() == JSEvent.DATACHANGE)

{
	// its a data change event
}
Table Row (tr)
classlastDetailRow
Table Cell (td)

Table Body (tbody)
idDOUBLECLICK
Table Row (tr)
idname
Table Cell (td)
DOUBLECLICK
Table Row (tr)
iddes
Table Cell (td)
Div
classsIndent
Constant returned by JSEvent.getType() in a method that is attached to an onDoubleClick event.
Table Row (tr)
idret
Table Cell (td)
Returns
Div
classsIndent
String
Table Row (tr)
idsam
Table Cell (td)
Sample
Div
classsIndent
Code Block
languagejavascript

if (event.getType() == JSEvent.DOUBLECLICK) 
{
	// its a double click event.
}
Table Row (tr)
classlastDetailRow
Table Cell (td)

Table Body (tbody)
idFOCUSGAINED
Table Row (tr)
idname
Table Cell (td)
FOCUSGAINED
Table Row (tr)
iddes
Table Cell (td)
Div
classsIndent
Constant returned by JSEvent.getType() in a method that is attached to an onFocusGained or the forms onElementFocusGained event.
Table Row (tr)
idret
Table Cell (td)
Returns
Div
classsIndent
String
Table Row (tr)
idsam
Table Cell (td)
Sample
Div
classsIndent
Code Block
languagejavascript

if (event.getType() == JSEvent.FOCUSGAINED)

{
	// its a focus gained event.
}
Table Row (tr)
classlastDetailRow
Table Cell (td)

Table Body (tbody)
idFOCUSLOST
Table Row (tr)
idname
Table Cell (td)
FOCUSLOST
Table Row (tr)
iddes
Table Cell (td)
Div
classsIndent
Constant returned by JSEvent.getType() in a method that is attached to an onFocusLost or the forms onElementFocusLost event.
Table Row (tr)
idret
Table Cell (td)
Returns
Div
classsIndent
String
Table Row (tr)
idsam
Table Cell (td)
Sample
Div
classsIndent
Code Block
languagejavascript

if (event.getType() == JSEvent.FOCUSLOST) 
{
	// its a focus lost event.
}
Table Row (tr)
classlastDetailRow
Table Cell (td)

Table Body (tbody)
idFORM
Table Row (tr)
idname
Table Cell (td)
FORM
Table Row (tr)
iddes
Table Cell (td)
Div
classsIndent
Constant returned by JSEvent.getType() in a method that is attached to a form event (like onShow) or command (like onDeleteRecord)
Table Row (tr)
idret
Table Cell (td)
Returns
Div
classsIndent
String
Table Row (tr)
idsam
Table Cell (td)
Sample
Div
classsIndent
Code Block
languagejavascript

if (event.getType() == JSEvent.FORM) 
{
	// its a form event or command
}
Table Row (tr)
classlastDetailRow
Table Cell (td)

Table Body (tbody)
idMODIFIER_ALT
Table Row (tr)
idname
Table Cell (td)
MODIFIER_ALT
Table Row (tr)
iddes
Table Cell (td)
Div
classsIndent
Constant for the ALT modifier that can be returned by JSEvent.getModifiers();
Table Row (tr)
idret
Table Cell (td)
Returns
Div
classsIndent
Number
Table Row (tr)
idsam
Table Cell (td)
Sample
Div
classsIndent
Code Block
languagejavascript

//test if the SHIFT modifier is used.
if (event.getModifiers() & JSEvent.MODIFIER_SHIFT)
{
	//do shift action
}
Table Row (tr)
classlastDetailRow
Table Cell (td)

Table Body (tbody)
idMODIFIER_CTRL
Table Row (tr)
idname
Table Cell (td)
MODIFIER_CTRL
Table Row (tr)
iddes
Table Cell (td)
Div
classsIndent
Constant for the CTRL modifier that can be returned by JSEvent.getModifiers();
Table Row (tr)
idret
Table Cell (td)
Returns
Div
classsIndent
Number
Table Row (tr)
idsam
Table Cell (td)
Sample
Div
classsIndent
Code Block
languagejavascript

//test if the SHIFT modifier is used.
if (event.getModifiers() & JSEvent.MODIFIER_SHIFT)
{
	//do shift action
}
Table Row (tr)
classlastDetailRow
Table Cell (td)

Table Body (tbody)
idMODIFIER_META
Table Row (tr)
idname
Table Cell (td)
MODIFIER_META
Table Row (tr)
iddes
Table Cell (td)
Div
classsIndent
Constant for the META modifier that can be returned by JSEvent.getModifiers();
Table Row (tr)
idret
Table Cell (td)
Returns
Div
classsIndent
Number
Table Row (tr)
idsam
Table Cell (td)
Sample
Div
classsIndent
Code Block
languagejavascript

//test if the SHIFT modifier is used.
if (event.getModifiers() & JSEvent.MODIFIER_SHIFT)
{
	//do shift action
}
Table Row (tr)
classlastDetailRow
Table Cell (td)

Table Body (tbody)
idMODIFIER_SHIFT
Table Row (tr)
idname
Table Cell (td)
MODIFIER_SHIFT
Table Row (tr)
iddes
Table Cell (td)
Div
classsIndent
Constant for the SHIFT modifier that can be returned by JSEvent.getModifiers();
Table Row (tr)
idret
Table Cell (td)
Returns
Div
classsIndent
Number
Table Row (tr)
idsam
Table Cell (td)
Sample
Div
classsIndent
Code Block
languagejavascript

//test if the SHIFT modifier is used.
if (event.getModifiers() & JSEvent.MODIFIER_SHIFT)
{
	//do shift action
}
Table Row (tr)
classlastDetailRow
Table Cell (td)

Table Body (tbody)
idNONE
Table Row (tr)
idname
Table Cell (td)
NONE
Table Row (tr)
iddes
Table Cell (td)
Div
classsIndent
Constant returned by JSEvent.getType() if the event is not used in a known event or command.
Table Row (tr)
idret
Table Cell (td)
Returns
Div
classsIndent
String
Table Row (tr)
idsam
Table Cell (td)
Sample
Div
classsIndent
Code Block
languagejavascript

if (event.getType() == JSEvent.NONE) 
{
	// type is not set.
}
Table Row (tr)
classlastDetailRow
Table Cell (td)

Table Body (tbody)
idRIGHTCLICK
Table Row (tr)
idname
Table Cell (td)
RIGHTCLICK
Table Row (tr)
iddes
Table Cell (td)
Div
classsIndent
Constant returned by JSEvent.getType() in a method that is attached to an onRightClick event.
Table Row (tr)
idret
Table Cell (td)
Returns
Div
classsIndent
String
Table Row (tr)
idsam
Table Cell (td)
Sample
Div
classsIndent
Code Block
languagejavascript

if (event.getType() == JSEvent.RIGHTCLICK) 
{
	// its a right click event.
}
Table Row (tr)
classlastDetailRow
Table Cell (td)


HTML Table
idproperty
classservoy sDetail
Colgroup Tag
Column
padding0px
width100%

Table Row (tr)
styleheight: 30px;
Table Head (th)
colspan1
Property Details
Table Body (tbody)
iddata
Table Row (tr)
idname
Table Cell (td)
data
Table Row (tr)
iddes
Table Cell (td)
Div
classsIndent
A data object that specific events can set, a user can set data back to the system for events that supports this.
Table Row (tr)
idret
Table Cell (td)
Returns
Div
classsIndent
Object
Table Row (tr)
idsam
Table Cell (td)
Sample
Div
classsIndent
Code Block
languagejavascript

...

// 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;

...

Table Row (tr)
classlastDetailRow
Table Cell (td)

HTML Table
idfunction
classservoy sDetail
Colgroup Tag
Column
padding0px
width100%

Table Row (tr)
styleheight: 30px;
Table Head (th)
colspan1
Method Details
Table Body (tbody)
idgetElementName
Table Row (tr)
idname
Table Cell (td)
getElementName
Table Row (tr)
idsig
Table Cell (td)
Span
stylemargin-right: 5px;
String
Span
stylefont-weight: bold;
getElementName
Span
()
Table Row (tr)
iddes
Table Cell (td)
Div
classsIndent
returns the name of the element, can be null if the form was the source of the event.
Table Row (tr)
idret
Table Cell (td)
Returns
Div
classsIndent
String

...

- a String representing the element name.
Table Row (tr)
idsam
Table Cell (td)
Sample
Div
classsIndent
Code Block
languagejavascript

...

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

...

Table Row (tr)
classlastDetailRow
Table Cell (td)

Table Body (tbody)
idgetFormName
Table Row (tr)
idname
Table Cell (td)
getFormName
Table Row (tr)
idsig
Table Cell (td)
Span
stylemargin-right: 5px;
String
Span
stylefont-weight: bold;
getFormName
Span
()
Table Row (tr)
iddes
Table Cell (td)
Div
classsIndent
returns the name of the form the element was placed on.
Table Row (tr)
idret
Table Cell (td)
Returns
Div
classsIndent
String

...

- a String representing the form name.
Table Row (tr)
idsam
Table Cell (td)
Sample
Div
classsIndent
Code Block
languagejavascript

...

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

...

Table Row (tr)
classlastDetailRow
Table Cell (td)

Table Body (tbody)
idgetModifiers
Table Row (tr)
idname
Table Cell (td)
getModifiers
Table Row (tr)
idsig
Table Cell (td)
Span
stylemargin-right: 5px;
Number
Span
stylefont-weight: bold;
getModifiers
Span
()
Table Row (tr)
iddes
Table Cell (td)
Div
classsIndent
Returns the modifiers of the event, see JSEvent.MODIFIER_XXXX for the modifiers that can be returned.
Table Row (tr)
idret
Table Cell (td)
Returns
Div
classsIndent
Number

...

- an int which holds the modifiers as a bitset.
Table Row (tr)
idsam
Table Cell (td)
Sample
Div
classsIndent
Code Block
languagejavascript

...

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

...

Table Row (tr)
classlastDetailRow
Table Cell (td)

Table Body (tbody)
idgetSource
Table Row (tr)
idname
Table Cell (td)
getSource
Table Row (tr)
idsig
Table Cell (td)
Span
stylemargin-right: 5px;
Object
Span
stylefont-weight: bold;
getSource
Span
()
Table Row (tr)
iddes
Table Cell (td)
Div
classsIndent
returns the source component/element of the event.
If it has a name the getElementName() is the name of this component.
Table Row (tr)
idret
Table Cell (td)
Returns
Div
classsIndent
Object

...

- an Object representing the source of this event.
Table Row (tr)
idsam
Table Cell (td)
Sample
Div
classsIndent
Code Block
languagejavascript

...

// 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();

...

Table Row (tr)
classlastDetailRow
Table Cell (td)

Table Body (tbody)
idgetTimestamp
Table Row (tr)
idname
Table Cell (td)
getTimestamp
Table Row (tr)
idsig
Table Cell (td)
Span
stylemargin-right: 5px;
Date
Span
stylefont-weight: bold;
getTimestamp
Span
()
Table Row (tr)
iddes
Table Cell (td)
Div
classsIndent
Returns the time the event occurred.
Table Row (tr)
idret
Table Cell (td)
Returns
Div
classsIndent
Date

...

- a Date when this event happened.
Table Row (tr)
idsam
Table Cell (td)
Sample
Div
classsIndent
Code Block
languagejavascript

...

event.getTimestamp();

...

Table Row (tr)
classlastDetailRow
Table Cell (td)

Table Body (tbody)
idgetType
Table Row (tr)
idname
Table Cell (td)
getType
Table Row (tr)
idsig
Table Cell (td)
Span
stylemargin-right: 5px;
String
Span
stylefont-weight: bold;
getType
Span
()
Table Row (tr)
iddes
Table Cell (td)
Div
classsIndent
returns the event type see the JSEvents constants what it can return.
Plugins can create events with there own types.
Table Row (tr)
idret
Table Cell (td)
Returns
Div
classsIndent
String

...

- a String representing the type of this event.
Table Row (tr)
idsam
Table Cell (td)
Sample
Div
classsIndent
Code Block
languagejavascript

...

if (event.getType() == JSEvent.ACTION)

...


{
	// its an action event.
}

...

Table Row (tr)
classlastDetailRow
Table Cell (td)

Table Body (tbody)
idgetX
Table Row (tr)
idname
Table Cell (td)
getX
Table Row (tr)
idsig
Table Cell (td)
Span
stylemargin-right: 5px;
Number
Span
stylefont-weight: bold;
getX
Span
()
Table Row (tr)
iddes
Table Cell (td)
Div
classsIndent
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.
Table Row (tr)
idret
Table Cell (td)
Returns
Div
classsIndent
Number

...

- an int representing the X position.
Table Row (tr)
idsam
Table Cell (td)
Sample
Div
classsIndent
Code Block
languagejavascript

...

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

...

Table Row (tr)
classlastDetailRow
Table Cell (td)

Table Body (tbody)
idgetY
Table Row (tr)
idname
Table Cell (td)
getY
Table Row (tr)
idsig
Table Cell (td)
Span
stylemargin-right: 5px;
Number
Span
stylefont-weight: bold;
getY
Span
()
Table Row (tr)
iddes
Table Cell (td)
Div
classsIndent
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.
Table Row (tr)
idret
Table Cell (td)
Returns
Div
classsIndent
Number

...

- an int representing the Y position.
Table Row (tr)
idsam
Table Cell (td)
Sample
Div
classsIndent
Code Block
languagejavascript

...

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

...

Table Row (tr)
classlastDetailRow
Table Cell (td)