CreateNewObject
Normally, you, as a modeler, create new objects by dragginge a new node from the Node toolbar into a Diagram.
This function lets you write functions or buttons to automate creation of new objects, or an entire module.
CreateNewObject(class, inModule, title, identifier, original)
Create a new Analytica object with the specified «class» in the module «inModule», and return a handle to the new object.
Key phrases: Make Object, New Object, Create Object, Make variable, New variable, Create variable
Parameters:
- «class»: the Class or type of the new object, such as Variable, Chance, Index, Module, FormNode, etc.
- «inModule»: the parent module to contain this object. It tries to position the node in the first available empty space in the diagram for this module.
- «title»: optional text for the Title attribute of the new object.
- «identifier»: the desired identifier. If that identifier is already in use, it adds digits to the end to make a unique identifier. If not specified, it uses the «title» or «class» to generate an identifier.
- «original»: If «class» is an Alias or FormNode (User input or output), the new object will refer to this original object.
The creation of a new object is a side-effect -- i.e. it makes a permanent change to the model -- so you can only use CreateNewObject in a button's OnClick attribute (or the Typescript Window) or a Function called from OnClick. You cannot use it in the definition of a Variable.
Keywords
Create new object, Create object, Make object, Make an object, New object, Add object, Add an object.
History
Introduced in Analytica 5.0.
Enable comment auto-refresher