MWAPI - INSELECT

1995 Version of ANSI (Equivalent to Current ISO Version) of Standard

INSELECT indicates the insertion point within a text value and a count of the number of characters selected. New characters inserted into the text value are added immediately following the position indicated by the insert value.

If seloff is 0 (zero), no characters are selected. If seloff is greater than 0 (zero), the seloff characters immediately following the position identified by insert (that is, characters insert+1 through insert+seloff) are selected. If seloff is less than 0 (zero), the seloff characters immediately preceding the position identified by insert (that is, characters insert+1+seloff through insert) are selected.

When an application attempts to assign a value to the INSELECT elattribute, the following series of actions are performed. If the value of insert is less than 0 (zero), it is set to 0 (zero). If the value of insert exceeds the length of the text value, insert is set to indicate the last character of the text value. If the value of seloff would select characters before the beginning of or after the end of the data value, seloff is set, respectively, to indicate that the selection extends to the first or final character in the value.

If there is no insertion point within the text value of a gadget, its INSERT elattribute is not defined. If no VALUE elattribute is defined, INSELECT is not defined and is not modifiable. If an application assigns values to a gadget’s INSELECT and VALUE elattributes with a single M[UMPS] MERGE command, the result is as if VALUE were defined first.