Line - Table or tree line

A line is always considered as line in a table or tree region instance. Lines are allocated on demand, i.e. when becoming visible. In some cases, lines do also exist, when not being visible, but this cannot be guaranteed.

Usually, lines are returned to the application as current or selected line when filling a table or tree region. Line objects should not be kept in memory, since they may become invalid after processing the line. Typically, lines are accessed in the doBeforeDataSet(), doAfterDataSet(), or in the doAfterSelectSet() handler.

One may also access lines other than the current line. In order to access a specific line, it may be identified by instance LOID, key value or column content. When accessing lines by content or LOID, the first line found in the table or tree will be located.

In order to refer to a specific line, one may construct a line with appropriate constructor. One may also call locate() in order to attach the Line object to a specific line in the list.