Scene :: createAndSelectOccurrenceFromSelection

Synopsis

Create a new occurrence and add the given occurrences as children and select it

GUI Dialog

Script function

scene.createAndSelectOccurrenceFromSelection(name[, children[, parent]]) -> occurrence

Parameters

   name (String) : Name of the new occurrence
   children (OccurrenceList) [optional] : Add given occurrence as children (if any)
   parent (Occurrence

) [optional] : If defined, the new occurrence will be created as a child of this parent. Else if children are defined, the first common parent of children will be used as a parent for this new occurrence. Last resort will be to use the root as parent

Return value

occurrence (Occurrence

) : Created occurrence