LineLength PowerScript function
Description
Determines the length of the line containing the insertion
point in an edit control.
Controls
RichTextEdit, MultiLineEdit, and EditMask controls
Syntax
|
1 |
<span>editname</span>.<span>LineLength</span> ( ) |
|
Argument |
Description |
|---|---|
|
editname |
The name of the RichTextEdit, MultiLineEdit, |
Return Values
Long. Returns the length of the line
containing the insertion point in editname. Returns
-1 if an error occurs. If editname is null, LineLength returns null.
Usage
If the control contains a selection instead of a single insertion
point, LineLength counts the line at the beginning
of the selection.
PowerBuilder remembers where the insertion point is in each
editable control. When the user moves the focus to another control,
you can still find out the length of the line most recently edited
by calling the LineLength function for that control.
Insertion point in editable controls
Because PowerBuilder remembers the position of the insertion
point, users can resume editing at the insertion point if they make
the control active by tabbing to it. When users make a control active
by clicking on it, they move the insertion point as well.
For an EditMask control, LineLength reports
the length of the mask, regardless of the number of characters the
user has entered.
Examples
If the insertion point is positioned anywhere in
line 5 of mle_Contact and line 5 contains
the text Select All, il_linelength is
set to 10 (the length of line 5):
|
1 |
integer li_linelength |
|
1 |
li_linelength = mle_Contact.<span>LineLength</span>() |