ItemChanged

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.

Applies to

Web DataWindow client control

Arguments

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.

Return codes

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.

Note: The server-side event that posts back to the ItemChanged client-side event can be triggered by these 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, and rejects the changed value entered by the user.