queryRowColChg

queryRowColChg(table:    Table input;
               newSheet: Integer;
               newRow:   Integer;
               newCol:   Integer): Boolean;

The queryRowColChg event occurs for the Table control when the user selects a cell that is not the current cell or a new sheet of the displayed table by using the mouse or the keyboard. Use this event method to prevent the user from moving the current cell until valid data has been entered.

If this event method is not implemented or it is implemented and returns true, the sheet, row, or column is changed to the selected table element and the rowColumnChg or the sheetChg event is called.

If this event is implemented and it returns false, the requested user action is ignored; that is, the current sheet, row, or column is not changed and the rowColumnChg or sheetChg event is not sent.

This event method is not called as a result of the table losing focus or when the sheet, row, or column is changed by logic.

When a collection is attached to a table and the current row is scrolled so that it will be discarded (outside of the displayed virtual window over the collection), the queryRowColChg and rowColumnChg event methods are called. If the queryRowColChg event is rejected, the scroll action is discarded. (Note that the queryRowColChg event passes the current row and column values as parameters, because the actual current row number remains unchanged after scrolling.)