Object Creation Handler Functions
Abstract
Used to specify custom actions to be performed when an object is created.
Syntax
Object Creation Handler Function Name (obj_hndl, source)
| Argument | Type | Description |
|---|---|---|
obj_hndl |
EtsT_Obj_Handle |
Handle to the object that was created. |
source |
EtsT_Nt_Object_Install_Src |
Source method by which the object was created (see Details for possible values). |
Return Type
void
no return value
Details
The object creation handler function allows a model developer to specify custom processing each time an object is added to a network model, regardless of how the object is added. For example, the object can be dragged from the object palette, pasted from the clipboard, created via rapid configuration or ETS, or created during a topology import. If an object creation handler function is specified for a model, it will be called whenever an instance of that model is added to a network model.
The source can be one of the following values:
EtsC_Nt_Object_Install_Src_Rapid_ConfigurationEtsC_Nt_Object_Install_Src_Topology_ImportEtsC_Nt_Object_Install_Src_ETS_ProgramEtsC_Nt_Object_Install_Src_ETS_DbEtsC_Nt_Object_Install_Src_PaletteEtsC_Nt_Object_Install_Src_PasteEtsC_Nt_Object_Install_Src_UndoEtsC_Nt_Object_Install_Src_Unknown