,

---

The matrixbutton statement helps implement buttons in a matrix object.

---

Parameters

This statement has two parameters:

clickbutton – Return object that was clicked on, or "" if none,

buttonrectangle – Return location of object that was clicked on, or "" if none.

---

Description

This statement helps implement buttons in a matrix object. It can be called when a user clicks within a matrix to find out which object within the matrix frame was clicked on, if any.

local mButton
matrixbutton mButton
if mButton="Add"
    ...
    ...
 elseif mButton="Delete"
    ...
    ...
 endif

Note: Unlike the matrixbuttonhelper statement, you don’t need to supply a list of object names to this statement. It figures out the object names automatically by scanning the objects in the frame rectangle. However, you must assign a name to the object for it to be detectable by this statement.

---

See Also

• dragarrayorder -- tracks dragging of a cell within a Matrix or Text List object, then reorders the array associated with that object accordingly.
• dragwithinmatrix -- tracks dragging of a cell within a Matrix or Text List object.
• 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.
• 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.