jsx3.gui.TreeAPI


AdoptFires before a record from this tree is adopted by another object.
Before DropFires continuously as the user drags the mouse over a record in this tree during a drag-and-drop operation.
Cancel DropFires after the user drags the mouse off this tree during a drag-and-drop operation.
ChangeFires when the user changes the selection of this tree.
Ctrl DropFires after the user drops a record on this tree while pressing the Ctrl key.
DataFires after the user expands a node with attribute @jsxlazy equal to '1'.
DestroyFires after this tree is removed from the DOM.
DragFires when the user drags a record(s) of this tree.
DropFires after the user drops a record on this tree.
ExecuteFires after the user double-clicks a record in this tree or presses the Enter key with focus in a record of this tree.
MenuFires after the user right-clicks this tree and before the bound context menu displays.
SelectDeprecated. Use the Change event instead.
SpyglassFires after the user hovers the mouse over this tree and before the spyglass displays.
ToggleFires when the user expands or collapses a record with nested records in this tree.

Executejsxexecute

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

Context Variables

this {jsx3.gui.Tree} - 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.
strRECORDIDS {Array<String>} - the list of CDF jsxids of the selected records.
objRECORD {jsx3.xml.Entity} - Deprecated. Use strRECORDID instead. the object handle to the CDF record.

Selectjsxselect

Deprecated. Use the Change event instead.
Fires after one or more records has changed from unselected to selected.

Context Variables

this {jsx3.gui.Tree} - 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 object.
strRECORDIDS {Array<String>} - the list of CDF jsxids of the selected records.

Changejsxchange

Fires when the user changes the selection of this tree.

Context Variables

this {jsx3.gui.Tree} - the object that publishes this event.
objEVENT {jsx3.gui.Event} - the browser event that triggers this event.
preVALUE {String | Array<String>} - the result of this.getValue() before the change event occurs.

Togglejsxtoggle

Fires when the user expands or collapses a record with nested records in this tree.

Context Variables

this {jsx3.gui.Tree} - the object that publishes this event.
objEVENT {jsx3.gui.Event} - the browser event that triggers this event.
strRECORDID {String} - the CDF jsxid of the toggled node.
objRECORD {jsx3.xml.Entity} - the CDF node for the toggled node.
bOPEN {boolean} - the new open value for object.

Dragjsxdrag

Fires when the user drags a record(s) of this tree. Canceling this event prevents the drag from occurring.
Cancelable: Evaluate to false to cancel event.

Context Variables

this {jsx3.gui.Tree} - 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.
strDRAGIDS {Array<String>} - an array containing the CDF jsxids of the dragged records.
objGUI {HTMLElement} - the HTML element acted upon.

Before Dropjsxbeforedrop

Fires continuously as the user drags the mouse over a record in this tree during a drag-and-drop operation. Canceling this event prevents the drop indicator from displaying.
Cancelable: Evaluate to false to cancel event.

Context Variables

this {jsx3.gui.Tree} - 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.
strDRAGIDS {Array<String>} - an array containing the CDF jsxids of the dragged records.
strRECORDID {String} - the CDF jsxid corresponding to the node hovered over in the view.
objGUI {HTMLElement} - the HTML element acted upon.

Cancel Dropjsxcanceldrop

Fires after the user drags the mouse off this tree during a drag-and-drop operation.

Context Variables

this {jsx3.gui.Tree} - 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.
strDRAGIDS {Array<String>} - an array containing the CDF jsxids of the dragged records.
strRECORDID {String} - the CDF jsxid corresponding to the node hovered over in the view.
objGUI {HTMLElement} - the HTML element acted upon.

Dropjsxdrop

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

Context Variables

this {jsx3.gui.Tree} - 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.
strDRAGIDS {Array<String>} - an array containing the CDF jsxids of the dragged records.
strRECORDID {String} - the CDF jsxid corresponding to the node hovered over in the view.
bINSERTBEFORE {boolean} - whether the dropped record should be inserted before strRECORDID. Otherwise, it is appended as a child of strRECORDID.
bALLOWADOPT {boolean} - whether the source of the dragged CDF record allows the adoption.

Ctrl Dropjsxctrldrop

Fires after the user drops a record on this tree 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.Tree} - 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.
strDRAGIDS {Array<String>} - an array containing the CDF jsxids of the dragged records.
strRECORDID {String} - the CDF jsxid corresponding to the node hovered over in the view.
bINSERTBEFORE {boolean} - whether the dropped record should be inserted before strRECORDID. Otherwise, it is appended as a child of strRECORDID.
bALLOWADOPT {boolean} - whether the source of the dragged CDF record allows the adoption.

Adoptjsxadopt

Fires before a record from this tree 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.Tree} - 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.
strRECORDIDS {Array<String>} - an array containing the jsxids of the records to adopt.
objTARGET {jsx3.gui.Tree} - the object that will adopt the record(s).
bCONTROL {boolean} - true if Ctrl Drop, false otherwise.

Spyglassjsxspy

Fires after the user hovers the mouse over this tree 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.Tree} - 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.

Menujsxmenu

Fires after the user right-clicks this tree 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.Tree} - the object that publishes this event.
objEVENT {jsx3.gui.Event} - the browser event that triggers this event.
objMENU {jsx3.gui.Menu} - the menu to display.
strRECORDID {String} - the CDF jsxid of the selected record.

Return Fields

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

Datajsxdata

Fires after the user expands a node with attribute @jsxlazy equal to '1'.

Context Variables

this {jsx3.gui.Tree} - the object that publishes this event.
objXML {jsx3.xml.Document} - the XML document of this tree.
objNODE {jsx3.xml.Entity} - the XML node that is being expanded.

Return Fields

bCLEAR {boolean} - if true, the jsxlazy attribute of objNODE is cleared.
arrNODES {Array<jsx3.xml.Entity>} - if not null, all child nodes of objNODE are removed and replaced with the contents of this array.

Destroyjsxdestroy

Fires after this tree is removed from the DOM.

Context Variables

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