,

---

The dragwithinmatrix statement tracks dragging of a cell within a Matrix or Text List object.

---

Parameters

This statement has two parameters:

startcell – cell number that was the starting point of the drag (cells are numbered starting from 1).

endcell – cell number that was the ending point of the drag (cells are numbered starting from 1). If the drag ends up outside the clicked object, the starting and ending cells will be the same.

---

Description

This statement tracks dragging of a cell within a Matrix or Text List object. It should only be called when the user has clicked on one of these objects (also, the Click/Release option for the object must be turned off).

local ocell,ncell
dragwithinmatrix ocell,ncell
if ocell<>ncell
    message "Dragged from "+ocell+" to "+ncell
endif

Note: The Text List or Matrix object that invokes this statement doesn’t need to have an object name – the dragwithinmatrix statement automatically figures out which object was clicked on.

---

See Also

• dragarrayorder -- tracks dragging of a cell within a Matrix or Text List object, then reorders the array associated with that object accordingly.
• info("matrixcell") -- returns the current cell number within a matrix object.
• info("matrixcelldata") -- returns the data associated with the current matrix object cell.
• info("matrixclickedframe") -- identifies which section of a matrix was clicked on.
• info("matrixclickedobject") -- identifies which named object in a matrix was clicked on (if any).
• info("matrixclickedobjectid") -- returns the object id of the object in a matrix that was clicked on (or zero if none).
• info("matrixclickinfo") -- identifies what section and what named object was clicked on in a matrix.
• info("matrixcolumn") -- returns the current column number within a matrix object.
• info("matrixname") -- returns the name of the matrix object being drawn, if any.
• info("matrixrow") -- returns the current row number within a matrix object.
• info("matrixseparator") -- function returns the separator associated with the current matrix.
• matrixbutton -- helps implement buttons in a matrix object.
• matrixbuttonhelper -- helps implement buttons in a matrix object.
• matrixclick -- will run the code belonging to an object that was clicked within a matrix frame.
• matrixclickedobjectid -- helps implement buttons in a matrix object.
• matrixredrawclickedcell -- redraws the matrix cell that was just clicked.

---

History

Version	Status	Notes
10.0	New	New in this version.