expand(scope,methodStr)

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:

Function [other Function type actions]

Group [operators of similar scope]

Formatting [other Formatting operators]

success boolean

v9.7.0

Baseline

As at baseline

[More on scoped arguments in Action Code]

expand(scope,methodStr)

For Map view, this operator alters notes at scope and alters their $Width and/or $Height to fit the $Name string, according to the method given in methodStr. This operator does not require a left-side recipient, although it does return a true/false value if it is desired to check.

There are three valid choices for methodStr. Given in parentheses below are the equivalent settings from Document Settings ▸ Maps ▸ If note name is too long: see the latter link for an explanation of the resulting change. The options are:

horizontally (same as Expand horizontally)
vertically (same as Expand vertically)
proportionately (same as Expand proportionately)

This function allows scoped resetting of map view note icon sizes. For example, to reset all child map notes using the proportional option, run this code on the maps' parent container:

expand(children, proportional);

To do similar but for an ad hoc selection on the current map, use a stamp with code:

expand(this, proportional);

recalling that a stamp is run individually on each selected item, so the code only needs a scope of the currently addressed item, i.e. this.