MoveToRow - cWebList

Instructs the client to navigate to the row matching the passed row index

Type: Procedure

Parameters: Integer iRowIndex

iRowIndexThe row index to navigate to

Procedure MoveToRow Integer iRowIndex

Call: Send MoveToRow iRowIndex


Send MoveToRow to instruct the client to navigate to the row matching the passed row index. The row index must be in the range 0 to (piRowCount-1).

In a data aware grid (pbDataAware = True), any time a row change occurs, the grid will check to see if current row has changes. If it has changes, that row must be saved or cleared. If pbAutoSave is True, which it usually is, a save will be attempted before the row change. The save is attempted by calling SaveSelectedRow. This function manages a save and may include user verifications and column validations. If the save is cancelled, the row navigation will be cancelled.

If a row is changed and pbAutoSave is False, the grid will attempt to undo the row changes. If the row is a new row, it will undo the changes by removing the row. If the row is not new, it will undo the changes by restoring the row to its pre-edited state. In either case, data loss verifications are sent (see Verify_Data_Loss_msg), which means that the row change can be cancelled.

With a default cWebGrid, you may not be aware of this underlying process. A row change will consist of a save, but there will be no user verification or no column validations. The save will just consist of an internal update of the data source. From the user's and the developer's perspective, it will just appear that you are changing rows. You can add verifications and validations as needed.

MoveToRow always attempts to make the moved-to row visible and uses its own logic to place the row in a sensible position within the visible grid.

See Also

MoveDownRow | MovePageDown | MovePageUp | MoveToFirstRow | MoveToLastRow | MoveToRowById | MoveUpRow