LineCount
PowerScript function
Description
Determines the number of lines in an edit control that allows
multiple lines.
Applies to
RichTextEdit, MultiLineEdit, EditMask, and DataWindow
controls
Syntax
|
1 |
editname.LineCount ( ) |
|
Argument |
Description |
|---|---|
|
editname |
The name of the DataWindow control, EditMask, |
Return value
Long.
Returns the number of lines in editname if it succeeds and -1 if an
error occurs. If editname is null, LineCount returns null.
Usage
LineCount counts each visible line, whether it was the result of
wrapping or carriage returns.
When you call LineCount for a DataWindow, it reports the number of
lines in the edit control over the current row and column. A user can
enter multiple lines in a DataWindow column only if it has a text datatype
and its box is large enough to display those lines. The size of the
column’s box determines the number of lines allowed in the column. When
the user is typing, lines do not wrap automatically; the user must press
enter to type additional lines.
In a MultiLineEdit control, lines wrap when the user’s typing fills
the control horizontally, unless either the HScrollBar or AutoHScroll
property is true. If horizontal scrolling is enabled with these
properties, the user must press enter to type additional lines.
A RichTextEdit control always contains an end-of-file mark even if
there is no text in the control. Therefore, its line count is always at
least 1. Other edit controls, when empty, have a line count of 0.
Examples
If the MultiLineEdit mle_Instructions has 9 lines, this example sets
li_Count to 9:
|
1 2 |
integer li_Count li_Count = mle_Instructions.LineCount() |
These statements display a MessageBox if fewer than two lines have
been entered in the MultiLineEdit mle_Address:
|
1 2 3 4 5 |
integer li_Lines li_Lines = mle_Address.LineCount() IF li_Lines < 2 THEN MessageBox("Warning", "2 lines are required.") END IF |