ER/Studio - Embarcadero Technologies Product Documentation

AUTOMATING ER/STUDIO >
When an entity is created, ER/Studio calls the CreateEntityHandler( ) function in the
ERSBasicHandlers.bas file.
When the function is called, ER/Studio passes to the handler the newly created entity (the current entity) and the
current diagram. The bodies of all the functions in the file are currently empty. You can extend the creation behavior of
any of the objects listed above by implementing the bodies of these functions.
Example:
NOTE: ER/Studio does not call the creation event functions for attributes and indexes until after you exit
from the Entity Editor.
Sub CreateEntityHandler(CurEntity As Object, CurDiagram As Object)
Dim Prefix as String
Dim EntityName as String
Dim NewEntityName as String
Prefix = "ERS"
EntityName = CurEntity.EntityName
NewEntityName = Prefix + EntityName
CurEntity.EntityName = NewEntityName
End Sub
In this example, the CreateEntityHandler function is modified so that a prefix of ERS is attached to the default entity
name each time you create a new entity.
Here is a more detailed explanation:
When you use the Entity Tool to create an entity, the default name for the entity is EntityX, for example, Entity1,
Entity2. By modifying the body of the CreateEntityHandler function in the manner shown above, the default entity
name becomes ERSEntityX (e.g. ERSEntity1, ERSEntity2).
Notes
• When ER/Studio starts, it reads in all the creation event handler functions from the file ERSBasicHandlers.bas.
Modifications to these functions while the application is running will have no effect. You must restart ER/Studio for
your modifications to take effect.
• You cannot declare a specific object type (for example, Entity) in the creation event handler functions. All objects
must be declared as the generic Object type.
See Also
Related Topics
Handling Update Events
You can customize the Entity update template subroutines.
To enable this option, click Tools > Options > Automation Options and then select Update Handlers.
EMBARCADERO TECHNOLOGIES > ER/STUDIO® 8.0.3 USER GUIDE 310