The token handler can compare this object with the object
previously given for this line to see if the token type at the end
of the line has changed (meaning subsequent lines might need to be
retokenized).

Returns the number of displayable lines
It can be greater than the number of lines of the buffer when using
soft wrap (a line can count for n lines), or when using folding, if
the foldings are collapsed