CTX_DBBase :: DBInsert - Before insert handler
The before insert handler is called before inserting a data instance in a collection ( DBP_Insert event). When the handler is called the instance to be inserted in the collection is not yet selected in the property handle. Hence, only attributes can be accessed in the instance in this phase. References and relationships are not accessible.
The before insert handler can deny creating the data instance by returning YES .
The handler can be overloaded in specialized context class implementations.
Return value: Success ( logical )