Value :: insertString - Insert string at given position
The function inserts the string passed in sString at position passed in iPosition .
When no instance is selected or when the value handle does not refer to a text field ( propertyDefinition.isText() ), the function throws an exception.
Implementation details
- cString - Constant string object
- iPosition
- Position in collection
The position of an instance in a collection depends on the selected index. if the collection is unsorted the position is the only way for accessing the instance.
For sorted collections the position is determined according to the instance key. If there is a contradiction between position and key value the position will be ignored.
Special positions are
CUR_INSTANCE
CUR_INSTANCE refers to the currently selected instance. If no instance is selected it refers to the first instance.
FIRST_INSTANCE
FIRST_INSTANCE (0) refers to the first instance in a collection according to the selected index (sort order).
LAST_INSTANCE
FIRST_INSTANCE (0) refers to the last instance in a collection according to the selected index (sort order).