ItemChanged
Description
Occurs when a field
in a DataWindow control has been modified and loses focus (for example,
the user presses Enter, the Tab key, or an arrow key or clicks the
mouse on another field within the DataWindow). It occurs before
the change is applied to the item. ItemChanged can also occur when
the Update function is called.
| Argument | Description |
|---|---|
| sender | String. Identifier for the client-side control. |
| row | Number. The number of the row containing the item whose value is being changed. |
| columnName | String. The name of the column containing the item. |
| newValue | String. The new data the user has specified for the item. |
Controls
Web DataWindow client control
Return Values
Set the return code to affect the outcome of the event:
- 0 (Default) Accept
the data value - 1 Reject the data value and do not allow
focus to change - 2 Reject the data value but allow the focus
to change
Usage
The ItemChanged event does not occur when the DataWindow control
itself loses focus.
Postback calls to the server-side ItemChanged event The corresponding server-side event is triggered by default
event handlers only after a cascade of events occurs: ItemChanged, Clicked, RowFocusChanging, RowFocusChanged, and ItemFocusChanged. Default postback
scripts for this event are PBDataWindow_ItemFocusChanged_AND_ItemChanged
and PBDataWindow_ItemFocusChanged_AND_ItemChanged_OR_ItemError. The
default event handler PBDataWindow_ItemChangedReject does
not cause a postback, but instead rejects the changed value entered
by the user.