Get(ActiveSelectionStart)

Category: Get

Syntax: Get ( ActiveSelectionStart )

Parameters: None

Data type returned: Number

Description:

Returns the position of the first character in the highlighted text of the current field. If no text is highlighted (that is, the user has simply clicked into a block of text), then the current position of the cursor is returned. It returns a blank value if no field is active. When multiple windows are open, only the active window is considered.

Remember that carriage returns, tabs, spaces, and other invisible characters are taken into account when evaluating Get ( ActiveSelectionStart ).

Used in conjunction with Get ( ActiveSelectionSize ), you can determine the string that a user has highlighted in any field, using the formula

 Middle ( Get (ActiveFieldContents); Get (ActiveSelectionStart) ;
 Get ( ActiveSelectionSize ))

Examples:

Function	Results
Get (ActiveSelectionStart)	Returns 1 if the user has selected an entire field, or if the insertion point is at the beginning of a field.