Class QCellClickEvent

Class QCellClickEvent An event to detect clicking on a table cell. Lots of things can be determined using this event by changing the JsReturnParam values. When this event fires, the javascript environment will have the following local variables defined: - this: The html object for the cell clicked. - event: The event object for the click.

Here are some examples of return params you can specify to return data to your action handler: this.id - the cell id this.tagName - the tag for the cell (either th or td) this.cellIndex - the column index that was clicked on, starting on the left with column zero $j(this).data('value') - the "data-value" attribute of the cell (if you specify one). Use this formula for any kind of "data-" attribute. $j(this).parent() - the jQuery row object $j(this).parent()[0] - the html row object $j(this).parent()[0].rowIndex - the index of the row clicked, starting with zero at the top (including any header rows). $j(this).parent().attr('id') or $j(this).parent()[0].id - the id of the row clicked on $j(this).parent().data("value") - the "data-value" attribute of the row. Use this formula for any kind of "data-" attribute. $j(this).parent().closest('table').find('thead').find('th')[this.cellIndex].id - the id of the column clicked in event.target - the html object clicked in. If your table cell had other objects in it, this will return the object clicked inside the cell. This could be important, for example, if you had form objects inside the cell, and you wanted to behave differently if a form object was clicked on, verses clicking outside the form object.

You can put your items in a javascript array, and an array will be returned as the strParameter in the action. Or you can put it in a javascript object, and a named array(hash) will be returned.

The default returns the array(row=>rowIndex, col=>colIndex), but you can override this with your action. For example:

new QAjaxAction ('yourFunction', null, 'this.cellIndex')

will return the column index into the strParameter, instead of the default.