CursorEnd (Property)

The mouse cursor allows you to easily determine where an action will be performed. For a control in edit mode, the cursor turns into a blinking vertical line, allowing you to identify the location of the next character typed.
Selected characters are displayed in inverted colors. The position of the cursor corresponds to the beginning of the area displayed in inverted colors.

For example:

	The input cursor is placed at the beginning of the input area. Its position is 1.
	The input cursor is placed at the end of the input area. Its position is 7 in this example.
	The input cursor is placed at the beginning of the area in "reverse video" (position 3 in this example). The Cursor property is used to get and change the end of the selected area.

CursorEnd is used to find out and modify the end position of selection of the mouse cursor in one of the following controls:

Edit control.
Editable Combo Box.
"Edit control" column and "Editable Combo Box" column in a Table control.
Versions 22 and later
Word Processing control.
New in version 22
Word Processing control.
Word Processing control.

Remark: To get the text selected in an edit control, an editable Combo Box or a column in a Table control, you can use SelectedText.

Versions 15 and later

This property is now available for Android applications.

New in version 15

This property is now available for Android applications.

Versions 18 and later

This property is now available in Windows Store apps mode.

New in version 18

This property is now available in Windows Store apps mode.

Versions 20 and later

This property is now available for columns of Table controls in Android applications.

New in version 20

This property is now available for columns of Table controls in Android applications.

Tip: To select a text section in an edit control from a button:

The option "Automatic erase" must not be enabled in the edit control (unless the entire content of the control must be deleted).
The button must be an "Interrupt" button and contain the following code, for example.

Versions 21 and later

This property is now available in Universal Windows 10 App mode.

New in version 21

This property is now available in Universal Windows 10 App mode.

Example

// -- Click code of BTN_Selection button (Interrupt button)
// Select the entire text
EDT_Edit1.Cursor = 1
EDT_Edit1.CursorEnd = Length(EDT_Edit1) + 1

// Deselect the text
EDT_Edit1.CursorEnd = EDT_Edit1.Cursor

// Place cursor at the end of the text
EDT_Edit1.CursorEnd = Length(EDT_Edit1) + 1
EDT_Edit1.Cursor = EDT_Edit1.CursorEnd

Syntax

Finding out the position of the last selected character Hide the details

<Position> = <Control used>.CursorEnd

<Position>: Integer

Position of last selected character + 1. If no character is selected, the Cursor and CursorEnd properties are equivalent. If the control is not in edit, the position is 0.

<Control used>: Control name

Name of the control in which a selection was performed.

Selecting a set of characters Hide the details

<Control used>.CursorEnd = <Number of selected characters>

<Control used>: Control name

Name of the control in which a selection must be performed.

<Number of selected characters>: Integer

The selected string is between the cursor position and the value passed to the CursorEnd property.
The smallest possible value is 1 (cursor on the left). The greatest value corresponds to the number of characters found in the control + 1.
Caution: If the content of the CursorEnd property is assigned to the property itself, the text is deselected: no character is displayed in reverse video.

Remarks

Limit: Selection in reverse video

The selection in reverse video is available only if the control is being edited. If the control is not in edit mode, the CursorEnd property returns 0.