Home > Reference > Script steps reference > Editing script steps > Set Selection

Set Selection

Purpose 

Allows the user to specify the starting and ending position of a selection in a field.

Format 

Set Selection [<table::field>; Start Position: <n>; End Position: <n>]

Options 

•	Select Go to target field or click Specify to specify the field whose contents you want to select.

•	Specify lets you set the starting and ending positions of a selection, either by entering the start and end numbers directly or by using a calculation to determine them.

Compatibility 

 

Where the script step runs	Supported
FileMaker Pro	Yes
FileMaker Server scheduled script	Yes
FileMaker Go	Yes
Custom Web Publishing	Yes
Instant Web Publishing	Yes
Runtime solution	Yes

Originated in 

FileMaker Pro 6.0 or earlier

Description 

The starting and ending values can be typed in directly or determined via a calculation. If no target field is specified the current active field is used.

Notes

•

Field position is determined by the number of characters, including spaces, beginning with position 1, the first character in the field. The selection includes all values beginning with the Start Position and concluding with the End Position. For example, if Field1 has the value “abcdefgh”, and the script parameters specify a start position of “3” and an end position of “6”, the script step will return the selection “cdef”.

•

If the start position is valid and the end position out of range, everything from the start position to the end of the field is selected. If the end position only is valid, the cursor moves to the end position, and nothing is selected. If both start and end positions are invalid, the cursor moves to the end of the field contents.

•	No action is taken if the user attempts to perform a selection on a container field.

•	Data selected out of visual range is scrolled into view.

Examples 

Go to Layout [“Data Entry”]
Set Selection [Table1::Account Number; Start Position:
5; End Position: 10]
Copy []

Related topics 

Script steps reference (alphabetical list)

Script steps reference (category list)