OnItemChange picture event

Declaration

Global handler:

 ENTRY   OnItemChange(IN INT _refId, IN INT _row, IN INT _col)
 ; script actions
 END    OnItemChange

Special handler:

 ENTRY XXX_OnItemChange(IN INT _row, IN INT _col) 
 ; script actions
 END XXX_OnItemChange

Parameters

_refId	Parameter of INT type (required for global handler).
XXX	Name of Reference variable connected to graphic object (without the character "_").
_row, _col	Row, column of the item that was changed.

Description

the picture event is being generated by the displayer of Browser type, if the user finished an item change. Item is defined by its row (the parameter _row) and its column (the parameter _col). The picture event can be used to check a value change.

Example

The picture event handle of the displayer of Browser type with the connected reference variable _browser displays the new value of changed item.

The Browser displays the structured variable _rec.

ENTRY browser_OnItemChange(IN  INT _row, IN  INT _col)
   IF _col = 1 THEN
     TEXT _msg
     _msg := "Value = " + %GetLocalItemValue(_rec\HBJ, _row, _col)
     MESSAGE _msg ON _FROM_HIP
   ENDIF
 END browser_OnItemChange
 
 BEGIN
   REDIM _rec[10]
 END

Global picture event handler:

ENTRY OnItemChange(IN INT _refId, INT _row, INT _col)

IF _refId = _browser THEN ; test that determines the Browser, where the picture event occurred

; script actions

  ENDIF
 END OnItemChange

Related pages:

Picture event handler
Picture events