Tinderbox v9 Icon

select(scope)


Operator Type: 

Operator Scope of Action: 

Operator Purpose: 

Operator First Added: 

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]

 9.6.0

 As at baseline

 [More on scoped arguments in Action Code]

Yes


select(scope)

From v9.6.0, 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().