Child pages
  • JSDNDEvent

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)
Number
Table Cell (td)
#MODIFIER_ALT
Constant for the ALT modifier that can be returned by JSDNDEvent.
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 JSDNDEvent.
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 JSDNDEvent.
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 JSDNDEvent.
Table Body (tbody)
Table Row (tr)
Table Cell (td)
String
Table Cell (td)
#ONDRAG
Constant returned by JSDNDEvent.
Table Body (tbody)
Table Row (tr)
Table Cell (td)
String
Table Cell (td)
#ONDRAGEND
Constant returned by JSDNDEvent.
Table Body (tbody)
Table Row (tr)
Table Cell (td)
String
Table Cell (td)
#ONDRAGOVER
Constant returned by JSDNDEvent.
Table Body (tbody)
Table Row (tr)
Table Cell (td)
String
Table Cell (td)
#ONDROP
Constant returned by JSDNDEvent.

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.
Table Body (tbody)
Table Row (tr)
Table Cell (td)
String
Table Cell (td)
#dataMimeType
The event data mime type.

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)
Number
Table Cell (td)
#getDragResult()
Returns the result of the drag action.
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 JSDNDEvent.
Table Body (tbody)
Table Row (tr)
Table Cell (td)
JSRecord
Table Cell (td)
#getRecord()
Returns the record of the event.
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 dnd event type see the JSDNDEvents 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)
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 JSDNDEvent.getModifiers();
Table Row (tr)
idret
Table Cell (td)
Returns
Number
Table Row (tr)
idsam
Table Cell (td)
Sample
Div
classsIndent
Code Block
languagejavascript
//test if the SHIFT modifier is used.
if (event.getModifiers() & JSDNDEvent.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 JSDNDEvent.getModifiers();
Table Row (tr)
idret
Table Cell (td)
Returns
Number
Table Row (tr)
idsam
Table Cell (td)
Sample
Div
classsIndent
Code Block
languagejavascript
//test if the SHIFT modifier is used.
if (event.getModifiers() & JSDNDEvent.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 JSDNDEvent.getModifiers();
Table Row (tr)
idret
Table Cell (td)
Returns
Number
Table Row (tr)
idsam
Table Cell (td)
Sample
Div
classsIndent
Code Block
languagejavascript
//test if the SHIFT modifier is used.
if (event.getModifiers() & JSDNDEvent.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 JSDNDEvent.getModifiers();
Table Row (tr)
idret
Table Cell (td)
Returns
Number
Table Row (tr)
idsam
Table Cell (td)
Sample
Div
classsIndent
Code Block
languagejavascript
//test if the SHIFT modifier is used.
if (event.getModifiers() & JSDNDEvent.MODIFIER_SHIFT)
{
	//do shift action
}
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 JSDNDEvent.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() == JSDNDEvent.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 JSDNDEvent.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() == JSDNDEvent.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 JSDNDEvent.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() == JSDNDEvent.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 JSDNDEvent.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() == JSDNDEvent.ONDROP) 
{
	// its a on drop event.
	var element = elements[event.getElementName()];
	// do drop on element
	return true;
}
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)

Table Body (tbody)
iddataMimeType
classnode
Table Row (tr)
idname
Table Cell (td)
dataMimeType
Table Row (tr)
iddes
Table Cell (td)
The event data mime type.
Table Row (tr)
idret
Table Cell (td)
Returns
String
Table Row (tr)
idsam
Table Cell (td)
Sample
Div
classsIndent
Code Block
languagejavascript
// only accept drag if data is a servoy record 
function onDragOver(event)
{
	if(event.dataMimeType.indexOf("application/x-servoy-record-object") == 0) return true;
	else return false;
}
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)
idgetDragResult
classnode
Table Row (tr)
idname
Table Cell (td)
getDragResult
Table Row (tr)
idsig
Table Cell (td)
Span
stylefloat: left; margin-right: 5px;
Number
Span
stylefloat: left; font-weight: bold;
idiets
getDragResult
Span
stylefloat: left;
idiets
()
Table Row (tr)
iddes
Table Cell (td)
Returns the result of the drag action.
Table Row (tr)
idret
Table Cell (td)
Returns
Number – a DRAGNDROP constant, representing the result of the drag action
Table Row (tr)
idsam
Table Cell (td)
Sample
Div
classsIndent
Code Block
languagejavascript
function onDragEnd(event)
{
	var dragResult = event.getDragResult();
	if(dragResult == DRAGNDROP.NONE)
	{
		// the drag was canceled
	}
	else if(dragResult == DRAGNDROP.COPY)
	{
		// the drag ended with a copy action
	}
	else if(dragResult == DRAGNDROP.MOVE)
	{
		// the drag ended with a move action
	}
}
Table Row (tr)
classlastDetailRow
Table Cell (td)

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 JSDNDEvent.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() & JSDNDEvent.MODIFIER_SHIFT)
{
	//do shift action
}
Table Row (tr)
classlastDetailRow
Table Cell (td)

Table Body (tbody)
idgetRecord
classnode
Table Row (tr)
idname
Table Cell (td)
getRecord
Table Row (tr)
idsig
Table Cell (td)
Span
stylefloat: left; margin-right: 5px;
JSRecord
Span
stylefloat: left; font-weight: bold;
idiets
getRecord
Span
stylefloat: left;
idiets
()
Table Row (tr)
iddes
Table Cell (td)
Returns the record of the event.
Table Row (tr)
idret
Table Cell (td)
Returns
JSRecord – Record of the event
Table Row (tr)
idsam
Table Cell (td)
Sample
Div
classsIndent
Code Block
languagejavascript
event.Record();
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
// 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
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 dnd event type see the JSDNDEvents constants what it can return.
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() == JSDNDEvent.ONDROP) 
{
	// it's a drop
}
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)