This page is not available in the language you have chosen. It will be displayed in English by default. If you would like to view it in a different language, you can try selecting another language.
Adds the provided entities as children of this entity.
- If child entity already has a parent, removes the entity from its current parent and adds it to the new one.
- Added child entities will move through their lifetime methods until they match the state of the new parent.
Verse using statement |
using { /Verse.org/SceneGraph } |
AddEntities<public><native><final>(NewChildEntities:[]entity)<transacts><no_rollback>:void
Parameters
AddEntities takes the following parameters:
| Name | Type | Description |
|---|---|---|
NewChildEntities |
[]entity |
Attributes, Specifiers, and Effects
Specifiers
The following specifiers determine how you can interact with AddEntities in your programs. For the complete list of specifiers, see the Specifiers Page.
| Specifier | Meaning |
|---|---|
public |
The identifier is universally accessible. You can use this on modules, classes, interfaces, structs, enums, methods, and data. |
native |
Indicates that the definition details of the element are implemented in C++. Verse definitions with the native specifier auto-generate C++ definitions that a developer can then fill out its implementation. You can use this specifier on classes, interfaces, enums, methods, and data. |
final |
You can only use the final specifier on classes and members of classes. When a class has the final specifier, you cannot create a subclass of the class. When a field has the final specifier, you cannot override the field in a subclass. When a method has the final specifier, you cannot override the method in a subclass. |
Effects
The following effects determine how AddEntities behaves in your programs. For the complete list of effects, see the Effect Specifers section of the Specifiers Page.
| Effect | Meaning |
|---|---|
transacts |
This effect indicates that any actions performed by the function can be rolled back. The transacts effect is required any time a mutable variable (var) is written. You'll be notified when you compile your code if the transacts effect was added to a function that can't be rolled back. Note that this check is not done for functions with the native specifier. |
no_rollback |
This is the default effect when no exclusive effect is specified. The no_rollback effect indicates that any actions performed by the function cannot be undone and so the function cannot be used in a failure context. This effect cannot be manually specified. |