-allowFieldSizeReset

(Merge only) (As of 3.3.008.01)

After a field's value is assigned via scripting, reset its dimensions to the designed size.

Syntax

-allowFieldSizeReset Y | N

Description

When set to Y (Yes), this option allows a field to reset back to its designed size, as long as Adjust Height or Adjust Width is enabled. The default option setting is N.

For example, the following script trims leading and trailing whitespace from the field value:

this._value = (this._value.trim()); 

If the original data included leading and/or trailing carriage returns or extra spaces that caused the field to grow, enabling -allowFieldSizeReset Y would cause the field to reset, based on the new, trimmed content.

This applies to values assigned using:

• this._value

• this._raw

• this._num