Get(ActiveSelectionSize)

Category: Get

Syntax: Get ( ActiveSelectionSize )

Parameters: None

Data type returned: Number

Description:

Returns the number of characters that are highlighted in the current field. The function returns 0 if no characters are highlighted, and returns a blank value if no field is active. When multiple windows are open (which leads to the possibility of multiple highlighted selections), only the active window is considered.

Carriage returns, tabs, spaces, and other invisible characters are counted by Get ( ActiveSelectionSize ).

When using Get() functions within field definitions, in most cases you should set the storage option to be "unstored" so that the field always displays current data.

Examples:

Function	Results
Get ( ActiveSelectionSize )	Would return 10 if a user had highlighted 10 characters in any field in the active window.