Determines the total number of characters in the selected text in an edit control, including spaces and line endings.
DataWindow type |
Method applies to |
|---|---|
PowerBuilder |
DataWindow control |
Web ActiveX |
DataWindow control |
long dwcontrol.SelectedLength ( )
number dwcontrol.SelectedLength ( )
Argument |
Description |
|---|---|
dwcontrol |
A reference to a DataWindow control. SelectedLength reports the length of the selected text in the edit control over the current row and column. |
Returns the length of the selected text in dwcontrol. If no text is selected, SelectedLength returns 0. If an error occurs, it returns -1.
If dwcontrol is null, in PowerBuilder and JavaScript the method returns null.
The characters that make up a line ending, produced by typing Ctrl+Enter or Enter, are different on different platforms. On Windows, they are a carriage return plus a line feed and equal two characters when calculating the length. On other platforms, a line ending can be a single character. A line that wraps has no line-ending character.
RichText DataWindows
For rich text controls, a carriage return plus a line feed
always count as a single character when calculating the text length.
PowerBuilder environment
For use with other PowerBuilder controls, see SelectedLength in
the PowerScript Reference.
If the selected text in the DataWindow dw_Contact is John Smith, then this example sets the variable to 10, the number of selected characters:
integer li_length
li_length = dw_Contact.SelectedLength()
