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.