Occurs when the current row is about to change in the DataWindow.
The current row of the DataWindow is not necessarily the same as the current row in the database.
The RowFocusChanging event occurs just before the RowFocusChanged event.
Applies to
Web DataWindow client control
Arguments
| Argument |
Description |
|---|
| sender |
String. Identifier for the client-side control. |
| currentRow |
Number. The number of the row that is current (before the row is deleted or its number changes). If the DataWindow object is empty, currentrow is 0, indicating there is no current row. |
| newRow |
Number. The number of the row that is about to become current. If the new row is going to be an inserted row, newrow is 0, indicating that it does not yet exist. |
Return codes
Set the return code to affect the outcome of the event:
- 0 — continue processing.
- 1 — prevent the focus from changing.
Usage
Typically the RowFocusChanging event is coded to respond to a mouse-click or keyboard action that would change the current row in the DataWindow object.
Note: The server-side event that posts back to the RowFocusChanging client-side event can be triggered by these default event handlers: PBDataWindow_RowFocusChanged, PBDataWindow_ClickedDifferentRow, and PBDataWindow_DelayedClickedDifferentRow.