select(scope)

Operator Type:

Operator Scope of Action:

Operator Purpose:

Data Type Returned:

Operator First Added:

Operator in Current Baseline:

Operator Last Altered:

Operator Uses Scoped Arguments:

Operator Has Newer Dot-Operator Variant:

Function [other Function type actions]

Group [operators of similar scope]

Data manipulation [other Data manipulation operators]

List [about List data type]

v9.6.0

Baseline

As at baseline

[More on scoped arguments in Action Code]

Yes

select(scope)

The select(scope) operator allows the document's current (UI) focus to be shifted. The scope argument defines a list of one or more notes. The argument may be a literal string, or the value of an attribute or variable.

select([/Note A;/Note B]);

select($MyList);

select(vItems);

This specialist operator assist in the scenario where, whilst running action code, it is necessary to change the selection such that the locus of 'this' changes. Some action code operators only address the currently selected item(s). The select(scope) operator allows the selection to be changed on the fly without the user having to do so via the UI.

Because using select without arguments has a distinct and different function is it listed separately: select().

See also—notes linking to here:

select()