If, for example, the selection provider is a text viewer ( {@link org.eclipse.jface.text.ITextViewer}), and a text selection is created for the range [5, 10], the line formation for the 5th character must not be determined and remembered at the point of creation. It can rather be determined at the point, when getStartLine is called. If the source viewer range [0, 15] has been changed in the meantime between the creation of the text selection object and the invocation of getStartLine, the returned line number may differ from the line number of the 5th character at the point of creation of the text selection object.
The contract of this interface is that weak in order to allow for efficient implementations.
Clients may implement this interface or use the default implementation provided by {@link org.eclipse.jface.text.TextSelection}.
@see org.eclipse.jface.text.TextSelection | |