CursorEnd (Property)

ONLINE HELP
WINDEV, WEBDEV AND WINDEV MOBILE

Version:

Home | Sign in | English

Help / WLanguage / WLanguage properties / Properties associated with windows, pages and controls

Definition
Limitation: Selection in reverse video

WINDEV

WEBDEV

WINDEV Mobile

Others

See also

CursorEnd (Property)

In french: FinCurseur

Not available

Definition

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 CursorEnd property gets and sets the end of the selected area.

The CursorEnd property gets and sets the end position of the mouse selection range in the following controls:

Edit control.
Editable Combo Box.
"Edit control" column and "Editable Combo Box" column in a Table control.
Word Processing control.
HTML Editor control.
Code Editor control.
New in version SaaS
Code Editor 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.

New in version SaaS

This property is now available in browser code for Code Editor controls.

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

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

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:
Edit control.
Editable Combo Box control.
"Edit control" column and "Editable Combo Box" column in a Table control.
Word Processing control.
HTML Editor control.
Code Editor control.

<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

Limitation: 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.