Returns the substring of text that makes up the specified line
number.
The number of lines can be obtained by calling
XAccessibleMultiLineText::getLineNumberAtIndex
with the index of the last character. In a loop, the last line
has been reached when TextSegment::SegmentEnd
of the returned value is equal to the index of the last
character of the text.
Parameter nLineNo
The number of the line to return the substring from.
The valid range is 0..getLineNumberAtIndex(getCharacterCount()).
Returns
Returns the requested text portion. This portion may be empty
or invalid when no appropriate text portion is found.
Throws
::com::sun::star::lang::IndexOutOfBoundsException
if the line number is invalid
Some text implementations place the caret at the end of the current
line when the End key gets pressed. Since the index of this position
is identical to the one of the first character of the following line,
XAccessibleMultiLineText::getLineNumberAtIndex will
return the line following the current one in this case.
Returns
Returns the requested text portion. This portion may be empty
or invalid if the paragraph object does not have a valid caret
position.
Some text implementations place the caret at the end of the current
line when the End key gets pressed. Since the index of this position
is identical to the one of the first character of the following line,
XAccessibleMultiLineText::getLineNumberAtIndex will
return the line following the current one in this case.
Returns
Returns the index of the line in which the caret is located or -1
if the paragraph does not have a valid caret position.