Designates a selection or cursor location in a field.
- Go to target field specifies the field whose contents you want to select. If no target field is specified, the active field is used.
- Start Position specifies the starting position of the selection.
- End Position specifies the ending position of the selection.
|FileMaker Data API||Yes|
|Custom Web Publishing||Yes|
Originated in version
6.0 or earlier
A position within a field is determined by the number of characters, including spaces, beginning with position 1, the first character in the field. A 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 step options specify a start position of 3 and an end position of 6, the script step will select "cdef". If the start position is in range and the end position is out of range, then everything from the start position to the end of the field is selected. (A position is in range if it is between 1 and the length of the text in the field.)
To move the cursor without selecting text, you can specify position values that are out of range or have the end position before the start position:
To move the cursor
Before position n
Start Position = n and End Position = 0
After position n
Start Position = 0 and End Position = n
To the start of the field
Start Position ≤ 1 and End Position = 0
To the end of the field
Start Position > m and End Position ≥ m, where m is the length of text in the field
Or set Start Position ≤ 0 and End Position < 0
- No action is taken if the user attempts to perform a selection on a container field.
- For all clients except FileMaker WebDirect, data selected out of visual range is scrolled into view.
- In FileMaker Go, this script step does not highlight selected text if the keyboard is hidden on the device.
Selects the first 5 digits of the Postal Code field.
Set Selection [Customers::Postal Code; Start Position: 1; End Position: 5]
Selects the number of paragraphs that the user specifies in the custom dialog box.
Show Custom Dialog ["How many paragraphs do you want to select?"; Products::Number of Paragraphs]
If [Get ( LastMessageChoice ) = 1]
Set Selection [Products::Description; Start Position: 1; End Position: Position ( Products::Description ; ¶ ; 1 ; Products::Number of Paragraphs )]
Moves the cursor before the third character in the field.
Set Selection [Table::Field1; Start Position: 3; End Position: 0]
Moves the cursor after the third character in the field.
Set Selection [Table::Field1; Start Position: 0; End Position: 3]
Moves the cursor to the start of the field.
Set Selection [Table::Field1; Start Position: 0; End Position: 0]
Moves the cursor to the end of the field.
Set Selection [Table::Field1; Start Position: -1; End Position: -1]