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. |
Web DataWindow client control
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
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.
