Child pages
  • JSEvent

Versions Compared

Key

  • This line was added.
  • This line was removed.
  • Formatting was changed.
Comment: Migration of unmigrated content due to installation of a new plugin
Hidden
DO NOT EDIT THE CONTENT OF THIS PAGE DIRECTLY, UNLESS YOU KNOW WHAT YOU'RE DOING.
		THE STRUCTURE OF THE CONTENT IS VITAL IN BEING ABLE TO EXTRACT CHANGES FROM THE PAGE AND MERGE THEM BACK INTO SERVOY SOURCE


HTML Table
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)
#ACTION
Constant returned by JSEvent.
Table Body (tbody)
Table Row (tr)
Table Cell (td)
String
Table Cell (td)
#DATACHANGE
Constant returned by JSEvent.
Table Body (tbody)
Table Row (tr)
Table Cell (td)
String
Table Cell (td)
#DOUBLECLICK
Constant returned by JSEvent.
Table Body (tbody)
Table Row (tr)
Table Cell (td)
String
Table Cell (td)
#FOCUSGAINED
Constant returned by JSEvent.
Table Body (tbody)
Table Row (tr)
Table Cell (td)
String
Table Cell (td)
#FOCUSLOST
Constant returned by JSEvent.
Table Body (tbody)
Table Row (tr)
Table Cell (td)
String
Table Cell (td)
#FORM
Constant returned by JSEvent.
Table Body (tbody)
Table Row (tr)
Table Cell (td)
Number
Table Cell (td)
#MODIFIER_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)
#MODIFIER_CTRL
Constant for the CTRL modifier that can be returned by JSEvent.
Table Body (tbody)
Table Row (tr)
Table Cell (td)
Number
Table Cell (td)
#MODIFIER_META
Constant for the META modifier that can be returned by JSEvent.
Table Body (tbody)
Table Row (tr)
Table Cell (td)
Number
Table Cell (td)
#MODIFIER_SHIFT
Constant for the SHIFT modifier that can be returned by JSEvent.
Table Body (tbody)
Table Row (tr)
Table Cell (td)
String
Table Cell (td)
#NONE
Constant returned by JSEvent.
Table Body (tbody)
Table Row (tr)
Table Cell (td)
String
Table Cell (td)
#ONDRAG
Constant returned by JSEvent.
Table Body (tbody)
Table Row (tr)
Table Cell (td)
String
Table Cell (td)
#ONDRAGEND
Constant returned by JSEvent.
Table Body (tbody)
Table Row (tr)
Table Cell (td)
String
Table Cell (td)
#ONDRAGOVER
Constant returned by JSEvent.
Table Body (tbody)
Table Row (tr)
Table Cell (td)
String
Table Cell (td)
#ONDROP
Constant returned by JSEvent.
Table Body (tbody)
Table Row (tr)
Table Cell (td)
String
Table Cell (td)
#RIGHTCLICK
Constant returned by JSEvent.

HTML Table
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)
#data
A data object that specific events can set, a user can set data back to the system for events that supports this.

HTML Table
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)
#getElementName()
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)
#getFormName()
returns the name of the form the element was placed on.
Table Body (tbody)
Table Row (tr)
Table Cell (td)
Number
Table Cell (td)
#getModifiers()
Returns the modifiers of the event, see JSEvent.
Table Body (tbody)
Table Row (tr)
Table Cell (td)
Object
Table Cell (td)
#getSource()
returns the source component/element of the event.
Table Body (tbody)
Table Row (tr)
Table Cell (td)
Date
Table Cell (td)
#getTimestamp()
Returns the time the event occurred.
Table Body (tbody)
Table Row (tr)
Table Cell (td)
String
Table Cell (td)
#getType()
returns the event type see the JSEvents constants what it can return.
Table Body (tbody)
Table Row (tr)
Table Cell (td)
Number
Table Cell (td)
#getX()
Returns the x position of the event, relative to the component that fired it, if applicable.
Table Body (tbody)
Table Row (tr)
Table Cell (td)
Number
Table Cell (td)
#getY()
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
classnode
Table Row (tr)
idname
Table Cell (td)
ACTION
Table Row (tr)
iddes
Table Cell (td)
Constant returned by JSEvent.getType() in a method that is attached to an onAction event.
Table Row (tr)
idret
Table Cell (td)
Returns
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
classnode
Table Row (tr)
idname
Table Cell (td)
DATACHANGE
Table Row (tr)
iddes
Table Cell (td)
Constant returned by JSEvent.getType() in a method that is attached to an onDataChange event.
Table Row (tr)
idret
Table Cell (td)
Returns
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
classnode
Table Row (tr)
idname
Table Cell (td)
DOUBLECLICK
Table Row (tr)
iddes
Table Cell (td)
Constant returned by JSEvent.getType() in a method that is attached to an onDoubleClick event.
Table Row (tr)
idret
Table Cell (td)
Returns
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
classnode
Table Row (tr)
idname
Table Cell (td)
FOCUSGAINED
Table Row (tr)
iddes
Table Cell (td)
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
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
classnode
Table Row (tr)
idname
Table Cell (td)
FOCUSLOST
Table Row (tr)
iddes
Table Cell (td)
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
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
classnode
Table Row (tr)
idname
Table Cell (td)
FORM
Table Row (tr)
iddes
Table Cell (td)
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
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
classnode
Table Row (tr)
idname
Table Cell (td)
MODIFIER_ALT
Table Row (tr)
iddes
Table Cell (td)
Constant for the ALT modifier that can be returned by JSEvent.getModifiers();
Table Row (tr)
idret
Table Cell (td)
Returns
Number
Table Row (tr)
idsee
Table Cell (td)
Also see
Div
classsIndent
.getModifiers
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
classnode
Table Row (tr)
idname
Table Cell (td)
MODIFIER_CTRL
Table Row (tr)
iddes
Table Cell (td)
Constant for the CTRL modifier that can be returned by JSEvent.getModifiers();
Table Row (tr)
idret
Table Cell (td)
Returns
Number
Table Row (tr)
idsee
Table Cell (td)
Also see
Div
classsIndent
.getModifiers
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
classnode
Table Row (tr)
idname
Table Cell (td)
MODIFIER_META
Table Row (tr)
iddes
Table Cell (td)
Constant for the META modifier that can be returned by JSEvent.getModifiers();
Table Row (tr)
idret
Table Cell (td)
Returns
Number
Table Row (tr)
idsee
Table Cell (td)
Also see
Div
classsIndent
.getModifiers
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
classnode
Table Row (tr)
idname
Table Cell (td)
MODIFIER_SHIFT
Table Row (tr)
iddes
Table Cell (td)
Constant for the SHIFT modifier that can be returned by JSEvent.getModifiers();
Table Row (tr)
idret
Table Cell (td)
Returns
Number
Table Row (tr)
idsee
Table Cell (td)
Also see
Div
classsIndent
.getModifiers
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
classnode
Table Row (tr)
idname
Table Cell (td)
NONE
Table Row (tr)
iddes
Table Cell (td)
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
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)
idONDRAG
classnode
Table Row (tr)
idname
Table Cell (td)
ONDRAG
Table Row (tr)
iddes
Table Cell (td)
Constant returned by JSEvent.getType() in a method that is attached to an onDrag event.
Table Row (tr)
idret
Table Cell (td)
Returns
String
Table Row (tr)
idsam
Table Cell (td)
Sample
Div
classsIndent
Code Block
languagejavascript
if (event.getType() == JSEvent.ONDRAG) 
{
   // its an ondrag event
   if (event.getElementName() == 'todragelement')
   	return DRAGNDROP.COPY
}
Table Row (tr)
classlastDetailRow
Table Cell (td)

Table Body (tbody)
idONDRAGEND
classnode
Table Row (tr)
idname
Table Cell (td)
ONDRAGEND
Table Row (tr)
iddes
Table Cell (td)
Constant returned by JSEvent.getType() in a method that is attached to an onDragEnd event.
Table Row (tr)
idret
Table Cell (td)
Returns
String
Table Row (tr)
idsam
Table Cell (td)
Sample
Div
classsIndent
Code Block
languagejavascript
if (event.getType() == JSEvent.ONDRAGEND) 
{
   // its an on drag end event.
   // return true if the drop has been completed successfully
   return event.isDropSuccess(); 
}
Table Row (tr)
classlastDetailRow
Table Cell (td)

Table Body (tbody)
idONDRAGOVER
classnode
Table Row (tr)
idname
Table Cell (td)
ONDRAGOVER
Table Row (tr)
iddes
Table Cell (td)
Constant returned by JSEvent.getType() in a method that is attached to an onDragOver event.
Table Row (tr)
idret
Table Cell (td)
Returns
String
Table Row (tr)
idsam
Table Cell (td)
Sample
Div
classsIndent
Code Block
languagejavascript
if (event.getType() == JSEvent.ONDRAGOVER) 
{
   // its an on drag over event.
   // return true if it over the right element.
   return event.getElementName() == 'candroponelement';
}
Table Row (tr)
classlastDetailRow
Table Cell (td)

Table Body (tbody)
idONDROP
classnode
Table Row (tr)
idname
Table Cell (td)
ONDROP
Table Row (tr)
iddes
Table Cell (td)
Constant returned by JSEvent.getType() in a method that is attached to an onDrop event.
Table Row (tr)
idret
Table Cell (td)
Returns
String
Table Row (tr)
idsam
Table Cell (td)
Sample
Div
classsIndent
Code Block
languagejavascript
if (event.getType() == JSEvent.ONDROP) 
{
   // its a on drop event.
   var element = elements[event.getElementName()];
   // do drop on element
   return true;
}
Table Row (tr)
classlastDetailRow
Table Cell (td)

Table Body (tbody)
idRIGHTCLICK
classnode
Table Row (tr)
idname
Table Cell (td)
RIGHTCLICK
Table Row (tr)
iddes
Table Cell (td)
Constant returned by JSEvent.getType() in a method that is attached to an onRightClick event.
Table Row (tr)
idret
Table Cell (td)
Returns
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
classnode
Table Row (tr)
idname
Table Cell (td)
data
Table Row (tr)
iddes
Table Cell (td)
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
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
classnode
Table Row (tr)
idname
Table Cell (td)
getElementName
Table Row (tr)
idsig
Table Cell (td)
Span
stylefloat: left; margin-right: 5px;
String
Span
stylefloat: left; font-weight: bold;
idiets
getElementName
Span
stylefloat: left;
idiets
()
Table Row (tr)
iddes
Table Cell (td)
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
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
classnode
Table Row (tr)
idname
Table Cell (td)
getFormName
Table Row (tr)
idsig
Table Cell (td)
Span
stylefloat: left; margin-right: 5px;
String
Span
stylefloat: left; font-weight: bold;
idiets
getFormName
Span
stylefloat: left;
idiets
()
Table Row (tr)
iddes
Table Cell (td)
returns the name of the form the element was placed on.
Table Row (tr)
idret
Table Cell (td)
Returns
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
classnode
Table Row (tr)
idname
Table Cell (td)
getModifiers
Table Row (tr)
idsig
Table Cell (td)
Span
stylefloat: left; margin-right: 5px;
Number
Span
stylefloat: left; font-weight: bold;
idiets
getModifiers
Span
stylefloat: left;
idiets
()
Table Row (tr)
iddes
Table Cell (td)
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
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
classnode
Table Row (tr)
idname
Table Cell (td)
getSource
Table Row (tr)
idsig
Table Cell (td)
Span
stylefloat: left; margin-right: 5px;
Object
Span
stylefloat: left; font-weight: bold;
idiets
getSource
Span
stylefloat: left;
idiets
()
Table Row (tr)
iddes
Table Cell (td)
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
Object – an Object representing the source of this event.
Table Row (tr)
idsam
Table Cell (td)
Sample
Div
classsIndent
Code Block
languagejavascript
var sourceDataProvider = event.getSource().getDataProviderID();
Table Row (tr)
classlastDetailRow
Table Cell (td)

Table Body (tbody)
idgetTimestamp
classnode
Table Row (tr)
idname
Table Cell (td)
getTimestamp
Table Row (tr)
idsig
Table Cell (td)
Span
stylefloat: left; margin-right: 5px;
Date
Span
stylefloat: left; font-weight: bold;
idiets
getTimestamp
Span
stylefloat: left;
idiets
()
Table Row (tr)
iddes
Table Cell (td)
Returns the time the event occurred.
Table Row (tr)
idret
Table Cell (td)
Returns
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
classnode
Table Row (tr)
idname
Table Cell (td)
getType
Table Row (tr)
idsig
Table Cell (td)
Span
stylefloat: left; margin-right: 5px;
String
Span
stylefloat: left; font-weight: bold;
idiets
getType
Span
stylefloat: left;
idiets
()
Table Row (tr)
iddes
Table Cell (td)
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
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
classnode
Table Row (tr)
idname
Table Cell (td)
getX
Table Row (tr)
idsig
Table Cell (td)
Span
stylefloat: left; margin-right: 5px;
Number
Span
stylefloat: left; font-weight: bold;
idiets
getX
Span
stylefloat: left;
idiets
()
Table Row (tr)
iddes
Table Cell (td)
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
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
classnode
Table Row (tr)
idname
Table Cell (td)
getY
Table Row (tr)
idsig
Table Cell (td)
Span
stylefloat: left; margin-right: 5px;
Number
Span
stylefloat: left; font-weight: bold;
idiets
getY
Span
stylefloat: left;
idiets
()
Table Row (tr)
iddes
Table Cell (td)
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
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)