---
title: "selectChildren"
canonical: "https://help.vicon.com/space/ShogunPost121/1253738333/selectChildren"
format: markdown
---
# Description

Selects the children of each specified module.

Use selectChildren when you need to add or subtract the children of the specified modules. You can also select all descendants of the specified module using the recursive option.

## Functional area

Selection

# Command syntax

## Syntax

> Macro (scroll-tablelayout)

|  |
| --- |
| `selectChildren node1 node2 ....[-a] [-r] [-recursive]` |

### Arguments

| Name | Type | Required | Comments |
| --- | --- | --- | --- |
| `node(s)` | string | yes | String name of node(s) to operate on. |

### Flags

> Macro (scroll-tablelayout)

| Name | Flag arguments | Argument type | Exclusive to | Comments |
| --- | --- | --- | --- | --- |
| `a` | 0 | — | r | Adds to the current selection in the scene |
| `r` | 0 | — | a | Removes form the current selection in the scene |
| `recursive` | 0 | — | — | Selects all children of the nodes specified |

## Return value

void 

> Macro (scroll-pagebreak)

## Examples

```plaintext
// This command selects the indicated nodes, and each
// of their immediate children.
selectChildren lcollar rcollar;
```

# Additional information

## Related commands

- [select](https://vicon-help.atlassian.net/wiki/spaces/ShogunPost121/pages/1253737508)
- [selectabilityOn](https://vicon-help.atlassian.net/wiki/spaces/ShogunPost121/pages/1253737978)
- [selectBranch](https://vicon-help.atlassian.net/wiki/spaces/ShogunPost121/pages/1253737247)
- [selectByName](https://vicon-help.atlassian.net/wiki/spaces/ShogunPost121/pages/1253739192)
- [selectByPart](https://vicon-help.atlassian.net/wiki/spaces/ShogunPost121/pages/1253736482)
- [selectBySide](https://vicon-help.atlassian.net/wiki/spaces/ShogunPost121/pages/1253738001)
- [selectByType](https://vicon-help.atlassian.net/wiki/spaces/ShogunPost121/pages/1253737710)
- [selectParent](https://vicon-help.atlassian.net/wiki/spaces/ShogunPost121/pages/1253737538)
- [selectSet](https://vicon-help.atlassian.net/wiki/spaces/ShogunPost121/pages/1253737834)
- [selectTree](https://vicon-help.atlassian.net/wiki/spaces/ShogunPost121/pages/1253736558)
- [setPrimary](https://vicon-help.atlassian.net/wiki/spaces/ShogunPost121/pages/1253736466)