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

Selects or deselects keys on the selected channels.

Use selectKeys when you need to work with specific key sets; Shogun Post allows single or multiple range selections. To select keys only within certain properties: Translation, or Rotation for example, use [selectProperty](https://vicon-help.atlassian.net/wiki/spaces/ShogunPost121/pages/1253738322) to include/exclude them.

## Functional area

Selection

# Command syntax

## Syntax

> Macro (scroll-tablelayout)

|  |
| --- |
| `selectKeys [-a] [-r] [-invert] [-all] [-ranges] [-primaryOnly]` |

### Arguments

None

### Flags

> Macro (scroll-tablelayout)

| Name | Flag arguments | Argument type | Exclusive to | Comments |
| --- | --- | --- | --- | --- |
| `a` | 0 | — | r, invert | Add keys in selected time ranges to current key selection |
| `r` | 0 | — | a, invert | Remove keys in selected time ranges from current key selection |
| `invert` | 0 | — | a, r, all | Inverts the selection from the currently selected keys to the unselected keys |
| `all` | 0 | — | ranges | Select all keys of all selected properties. |
| `ranges` | 0 | — | all | Select all keys on currently active properties that lie within the selected time ranges. |
| `primaryOnly` | 0 | — | — | Selects keys on the primary Module only. |

## Return value

void

## Examples

```plaintext
// In this example 3 objects are selected, then a range
// within the playRange, then a subset of the object's properties,
// finally selecting the range of keys falling within the 
// indicated range on the indicated properties.
select LMWT LFWT LBWT;
selectRange 200 240;
selectProperty Translation;
selectKeys -ranges;
```

# Additional information

## Related commands

- [select](https://vicon-help.atlassian.net/wiki/spaces/ShogunPost121/pages/1253737508)
- [selectRange](https://vicon-help.atlassian.net/wiki/spaces/ShogunPost121/pages/1253736590)