fgl_dialog_setselection()

Selects the text in the current field.

Syntax

fgl_dialog_setselection(
   start INTEGER,
   end INTEGER )
  1. start defines the edit cursor position.
  2. end defines the selection end position.

Usage

A call to fgl_dialog_setselection(cursor, end) sets the text selection in the current form field. The start parameter defines the character position of the edit cursor (equivalent to fgl_dialog_getcursor() position), while end defines the character position of the end of the text selection (equivalent to fgl_dialog_getselectionend() position).

Important: When using byte length semantics, the positions are expressed in bytes. When using char length semantics, the unit is characters. This matters when using a multibyte locale such as UTF-8.

start can be lower, greater or equal to end.

This function has only an effect when staying in the current field, it is not recommended to call it in an AFTER FIELD or AFTER ROW event for example.