SelectedStart PowerScript function
Description
Reports the position of the first selected character in an
editable control.
Controls
DataWindow, EditMask, MultiLineEdit, SingleLineEdit, RichTextEdit, DropDownListBox,
and DropDownPictureListBox controls
Syntax
|
1 |
<span>editname</span>.<span>SelectedStart</span> ( ) |
|
Argument |
Description |
|---|---|
|
editname |
The name of the DataWindow, EditMask, For a DataWindow, it reports the starting position in the |
Return Values
Long. Returns the starting position of
the selected text in editname. If no text is selected, SelectedStart returns
the position of the character immediately following the insertion
point. If an error occurs, SelectedStart returns
-1. If editname is null, SelectedStart returns null.
Usage
For all controls except RichTextEdit, SelectedStart counts
from the start of the text and includes spaces and line endings.
For RichTextEdit controls, SelectedStart counts
from the start of the line on which the selection begins. The start
is at the opposite end of the selection from the insertion point.
For example, if the user dragged back to make the selection, the
start of the selection is at the end of the highlighted text and
the insertion point is before the start. Use the Position function
to get information about the start and end
of the selection.
Focus and the selection in a drop-down list
When a DropDownListBox or DropDownPictureListBox loses focus,
the selected text is no longer selected.
Examples
If the
MultiLineEdit mle_Comment contains Closed, and
for Vacation July 3 to July 10Vacation is
selected, then this example sets li_Start to 12
(the position of the first character in Vacation):
|
1 |
integer li_Start |
|
1 |
li_Start = mle_Comment.<span>SelectedStart</span>() |