jsx3.gui.GridAPI


AdoptFires before a record from this grid is adopted by another object.
After AppendFires after the user adds a CDF record and HTML table record (TR).
After EditFires after the user finishes an edit session and before an edit is committed.
After ResizeFires after the user resizes a column of this grid.
After SortFires after the user sorts this grid.
Before AppendFires when the user adds a new CDF record and before the change is committed.
Before EditFires when the user begins an edit session.
Before ResizeFires after the user releases the mouse after resizing a column of this grid and before the resize is committed.
Before SortFires when the user clicks on the header cell of a sortable column in this grid and before the records are sorted.
Ctrl DropFires after the user drops a record on this grid while pressing the Ctrl key.
DestroyFires after this grid is removed from the DOM.
DragFires when the user drags this grid.
DropFires after the user drops a record on this grid.
ExecuteFires after the user double-clicks a record or presses the Enter key with focus in a record of this grid.
MenuFires after the user right-clicks this grid and before the bound context menu displays.
SelectFires after cell selection has changed but only if the cell has no edit mask.
SpyglassFires after the user hovers the mouse over this grid and before the spyglass displays.

Executejsxexecute

Fires after the user double-clicks a record or presses the Enter key with focus in a record of this grid.

Context Variables

this {jsx3.gui.Grid} - the object that publishes this event.
strRECORDID {String} - the CDF jsxid of the selected record.
intCOLUMNINDEX {int} - the index of the column that receives the execute action.

Selectjsxselect

Fires after cell selection has changed but only if the cell has no edit mask.

Context Variables

this {jsx3.gui.Grid} - the object that publishes this event.
strRECORDID {String} - CDF jsxid of the selected record, null if a deselection event.
intCOLUMNINDEX {int} - the index of the column that receives the select action, null if a deselection event.

Dragjsxdrag

Fires when the user drags this grid. Canceling this event prevents the drag from occurring.
Cancelable: Evaluate to false to cancel event.

Context Variables

this {jsx3.gui.Grid} - the object that publishes this event.
objEVENT {jsx3.gui.Event} - the browser event that triggers this event.
strDRAGTYPE {String} - the type of drag (JSXDragType).
strDRAGID {String} - the CDF jsxid of the record to be dragged.
objGUI {HTMLElement} - the HTML element acted upon.
strRECORDID {String} - the CDF jsxid of the record to be dragged, same as strDRAGID.
intCOLUMNINDEX {int} - the index of the column where the drag begins.

Dropjsxdrop

Fires after the user drops a record on this grid. Canceling this event prevents the CDF adoption from occurring.
Cancelable: Evaluate to false to cancel event.

Context Variables

this {jsx3.gui.Grid} - the object that publishes this event.
objEVENT {jsx3.gui.Event} - the browser event that triggers this event.
objSOURCE {jsx3.gui.Block} - the object where the drag begins.
strDRAGTYPE {String} - the type of drag (JSXDragType).
strDRAGID {String} - the CDF jsxid of the dragged record.
strRECORDID {String} - the CDF jsxid of the record that receives the drop.
intCOLUMNINDEX {int} - the index of the column that receives the drop.
bALLOWADOPT {boolean} - whether the source of the dragged CDF record allows the adoption.

Ctrl Dropjsxctrldrop

Fires after the user drops a record on this grid while pressing the Ctrl key. Canceling this event prevents the CDF adoption from occurring.
Cancelable: Evaluate to false to cancel event.

Context Variables

this {jsx3.gui.Grid} - the object that publishes this event.
objEVENT {jsx3.gui.Event} - the browser event that triggers this event.
objSOURCE {jsx3.gui.Block} - the object where the drag begins.
strDRAGTYPE {String} - the type of drag (JSXDragType).
strDRAGID {String} - the CDF jsxid of the dragged record.
strRECORDID {String} - the CDF jsxid of the record that receives the drop.
intCOLUMNINDEX {int} - the index of the column that receives the drop.
bALLOWADOPT {boolean} - whether the source of the dragged CDF record allows the adoption.

Adoptjsxadopt

Fires before a record from this grid is adopted by another object. Canceling this event prevents the CDF adoption from occurring.
Cancelable: Evaluate to false to cancel event.

Context Variables

this {jsx3.gui.Grid} - the object that publishes this event.
objEVENT {jsx3.gui.Event} - the browser event that triggers this event.
strRECORDID {String} - the CDF jsxid of the record to adopt.
objTARGET {jsx3.gui.Grid} - the object that will adopt the record(s).
bCONTROL {boolean} - true if control drop, false otherwise.

Spyglassjsxspy

Fires after the user hovers the mouse over this grid and before the spyglass displays. The event script must evaluate to the HTML content to display in the spyglass. Canceling this event prevents the spyglass from displaying.
Cancelable: Evaluate to false to cancel event.

Context Variables

this {jsx3.gui.Grid} - the object that publishes this event.
objEVENT {jsx3.gui.Event} - the browser event that triggers this event.
strRECORDID {String} - the CDF jsxid of the spied record.
intCOLUMNINDEX {int} - the index of the column that receives the spy.

Menujsxmenu

Fires after the user right-clicks this grid and before the bound context menu displays. Canceling this event prevents the menu from displaying.
Cancelable: Evaluate to false to cancel event.

Context Variables

this {jsx3.gui.Grid} - the object that publishes this event.
objEVENT {jsx3.gui.Event} - the browser event that triggers this event.
strRECORDID {String} - the CDF jsxid of the selected record.
intCOLUMNINDEX {int} - the index of the column that receives the menu action.
objMENU {jsx3.gui.Menu} - the menu to display.

Return Fields

objMENU {jsx3.gui.Menu} - use this field to override the default menu with an instance of jsx3.gui.Menu.

Before Sortjsxbeforesort

Fires when the user clicks on the header cell of a sortable column in this grid and before the records are sorted. Canceling this event prevents the sort from occurring.
Cancelable: Evaluate to false to cancel event.

Context Variables

this {jsx3.gui.Grid} - the object that publishes this event.
objEVENT {jsx3.gui.Event} - the browser event that triggers this event.
intCOLUMNINDEX {int} - the index of the column just clicked.

Return Fields

intCOLUMNINDEX {int} - use this field to sort on a column other than the one that the user clicked on.

After Sortjsxaftersort

Fires after the user sorts this grid.

Context Variables

this {jsx3.gui.Grid} - the object that publishes this event.
objEVENT {jsx3.gui.Event} - the browser event that triggers this event.
intCOLUMNINDEX {int} - the index of the column that the grid is sorted on.

Before Resizejsxbeforeresize

Fires after the user releases the mouse after resizing a column of this grid and before the resize is committed. Canceling this event prevents the resizing from occurring.
Cancelable: Evaluate to false to cancel event.

Context Variables

this {jsx3.gui.Grid} - the object that publishes this event.
objEVENT {jsx3.gui.Event} - the browser event that triggers this event.
intCOLUMNINDEX {int} - the index of the column being resized.

After Resizejsxafterresize

Fires after the user resizes a column of this grid. Canceling this event prevents the resizing from occurring.
Cancelable: Evaluate to false to cancel event.

Context Variables

this {jsx3.gui.Grid} - the object that publishes this event.
objEVENT {jsx3.gui.Event} - the browser event that triggers this event.
intCOLUMNINDEX {int} - the index of the column being resized.
intDIFF {int} - the pixel difference in width.
intOLDWIDTH {int} - the old width of the column.
vntWIDTH {int | String} - the width of the column in implied pixels or percentage.

Return Fields

vntWIDTH {int | String} - use this field to set the resulting column width to a value other than the width at which the user released the mouse.

Before Appendjsxbeforeappend

Fires when the user adds a new CDF record and before the change is committed.

Context Variables

this {jsx3.gui.Grid} - the object that publishes this event.
objMASTERRECORD {Object<String,String>} - the CDF record to append as a JavaScript object.

After Appendjsxafterappend

Fires after the user adds a CDF record and HTML table record (TR).

Context Variables

this {jsx3.gui.Grid} - the object that publishes this event.
objMASTERRECORD {Object<String,String>} - the CDF record to append as a JavaScript object.
objTR {HTMLElement} - the native HTML object reference to the new element.

Before Editjsxbeforeedit

Fires when the user begins an edit session. Canceling this event prevents the edit mask from displaying.
Cancelable: Evaluate to false to cancel event.

Context Variables

this {jsx3.gui.Grid} - the object that publishes this event.
objEVENT {jsx3.gui.Event} - the browser event that triggers this event.
strRECORDID {String} - the CDF jsxid of the selected record.
strATTRIBUTENAME {String} - the CDF attribute name without the leading @ symbol.
objMASK {jsx3.gui.Block} - handle to the edit mask instance.
intCOLUMNINDEX {int} - the index of the affected column.

After Editjsxafteredit

Fires after the user finishes an edit session and before an edit is committed.

Context Variables

this {jsx3.gui.Grid} - the object that publishes this event.
objEVENT {jsx3.gui.Event} - the browser event that triggers this event.
strRECORDID {String} - the CDF jsxid of the selected record.
strATTRIBUTENAME {String} - the CDF attribute name without the leading @ symbol.
strATTRIBUTEVALUE {String} - the CDF attribute value.
objMASK {jsx3.gui.Block} - the handle to the edit mask instance.
objGUI {HTMLElement} - the HTML Table cell (TD) in the view.
intCOLUMNINDEX {int} - the index of the affected column.

Destroyjsxdestroy

Fires after this grid is removed from the DOM.

Context Variables

this {jsx3.gui.Grid} - the object that publishes this event.
objPARENT {jsx3.app.Model} - the parent of this grid before it is removed from the DOM.