SCROLL LINES

version 2004.1 (Modified)

SCROLL LINES ({*; }object{; position{; *}})

The SCROLL LINES command allows scrolling lines of a list form (displayed using the MODIFY SELECTION or DISPLAY SELECTION commands), a subform or a list box so that the first selected record/row or a specific record/row is displayed.

If you pass the first optional * parameter, you indicate that the object parameter is the name of a subform or list box object (in this case, pass a string in object). If you do not pass anything in this parameter, you indicate that the object parameter is a table (list form table or subform table) or a variable (list box).

If you do not pass the position parameter, the command provokes the vertical scroll of lines of the list so that the first highlighted line in the list is visible. If no line is selected, the command does nothing. If at least one selected line is already visible, the command does nothing.

The position parameter allows you to indicate the number of the line to display. If you pass this parameter, the command provokes the vertical scroll of lines of the list so that the set line is visible (highlighted or not). If the line is already visible, the command does nothing. For list forms and subforms, this number is the number of the line among the current selection (its position). For list boxes, this number is the number of the row among all the object rows (including hidden rows).

If you pass the second optional * parameter, the line made visible using the command (if the list was scrolled) will be placed in the first position of the list.

Note: The HIGHLIGHT RECORDS command features an optional * parameter that allows delegating scroll management to the SCROLL LINES command.

HIGHLIGHT RECORDS, SELECT LISTBOX ROW.