The ui.gadgets.line-support vocabulary provides common code shared by gadgets which display a sequence of lines of text. Currently, the two gadgets that use it are Editor gadgets and Table gadgets.

The class of line gadgets:

line-gadget

line-gadget? ( object -- ? )

Line gadgets are backed by a model which must be a sequence. The number of lines in the gadget is the length of the sequence.

Line gadgets cannot be created and used directly, instead a subclass must be defined:

new-line-gadget ( class -- gadget )

Subclasses must implement a generic word:

draw-line ( line index gadget -- )

Two optional generic words may be implemented; if they are not implemented in the subclass, a default implementation based on font metrics will be used:

line-height ( gadget -- n )

line-leading ( gadget -- n )

Validating line numbers:

validate-line ( m gadget -- n )

Working with visible lines:

visible-lines ( gadget -- n )

first-visible-line ( gadget -- n )

last-visible-line ( gadget -- n )

Converting y co-ordinates to line numbers, and vice versa:

line>y ( n gadget -- y )

y>line ( y gadget -- n )