/
OnBeforeEditItem

OnBeforeEditItem

OnBeforeEditItem picture event

Declaration

Global handler:

ENTRY OnBeforeEditItem(IN INT _refId, IN INT _row, _col, RECORD (*STRUCTURE DEFINITION*) _rowData, BOOL _bAllowEdit) ; operations END OnBeforeEditItem


Special handler:

ENTRY XXX_OnBeforeEditItem(IN INT _row, _col, RECORD (*STRUCTURE DEFINITION*) _rowData, BOOL _bAllowEdit) ; operations END XXX_OnBeforeEditItem

Parameters

_refId

For global operation - mandatory input parameter of the Int. type. 

XXX

Name of the Reference variable connected to the graphic object without the  introductory sign "_".

_row, _col

Row, column of a cell of which value needs to be approved.  

_rowData

Structure representing edited row. 

_bAllowEdit

Output parameter - allowance indication of value editing. 

Description

The event is generated by the diplayer of the Browser type in the moment before the cell editing beginning. The cell is identified by its row (_row) and column (_col). 

It is used when it is necessary to pre-fill the cell value in the editing window. In such case, a handler sets the cell in the _rowData parameter to the required value. This set value will be pre-filled for the user when starting to edit cells. Setting of the _rowData cell in a column different from _col is ignored. 


If an event handler sets output parameter _bAllowEdit to the @FALSE value, the user will not be allowed to edit a cell. 
If an event handler sets output paramete_bAllowEdit to the @TRUE value, the user will be allowed to edit a cell. 

Example

In the example, there is a displayer event handler of the Browser type with the assigned reference variable _browser and connected structural variable of the SD.Params type that will pre-fill the item "Name". 

 

ENTRY browser_OnBeforeEditItem(IN INT _row, IN INT _col, RECORD (SD.Params) _rowData, BOOL _bAllowEdit) IF _row = 1 THEN _rowData[1]^Name:= "Name1" ENDIF END browser_OnBeforeEditItem

 

Global picture event handler:

 

ENTRY OnBeforeEditItem(IN INT _refId, IN INT _row, IN INT _col, RECORD (SD.Params) _rowData, BOOL _bAllowEdit) IF _refId = _browser THEN IF _row = 1 THEN _rowData[1]^Name:= "Name1" ENDIF ENDIF END OnBeforeEditItem