GUIBaseContext :: doBeforeInitializeData - Pre-event handler for initialize data events

The pre-event handler for a DEV_Initialize event is called from within an AppendEntry or InsertEntry action. The handler allows providing or initialize key value and/or data for the new instance to be created. The event is fired before a key value has been entered by user. In order to update instance data, the new instance can be provided by calling newInstance () .

By setting or removing the key value for the instance the handler may control, whether a new instance dialog is suppressed (key value available) or displayed (key value empty).

In order to refuse creating a new instance the handler may return 1 .

The handler should return one of the following values:

• -1 (not handled) - the event handler will be removed from the handler list and is not called anymore.
• 1 (refuse) - Requested action will not be executed.
• 0 (ok) - Action is permitted to be executed.