set-first-visible-line

Generic Function

Package: common-graphics

Arguments: window line &optional relative-p

If relative-p is nil (the default), this function scrolls the window so that line is the first visible line. If relative-p is true, scrolls the window so the first visible line is line lines from the current position.

window can be a text-edit-window, a text-edit-pane, a multi-line-editable-text component, or a single-item-list or multi-item-list component.

line should be an integer, identifying the line to be displayed (if relative-p is nil) or the number of lines from the current position to be displayed (if relative-p is true). Zero indicates the topmost line.

relative-p is a boolean which controls whether line should be interpreted as an absolute (value nil, the default) or a relative (value true) number.

The return value is undefined.

Note: incompatible change in release 6.0: in releases prior to 6.0, when a frame-with-single-child instance was passed to this operator, the operator was actually applied to the child (the result of applying frame-child to the frame-with-single-child instance). In release 6.0, this redirection no longer occurs. If you intend this operator to apply to the frame-child, pass that to this operator rather than the parent. This is a non-backward-compatible-change. See the release notes for more information.

Common Graphics and IDE documentation is described in About Common Graphics and IDE documentation in cgide.htm.

The documentation is described in introduction.htm and the index is in index.htm.

Copyright (c) 1998-2000, Franz Inc. Berkeley, CA., USA. All rights reserved.

Created 2000.10.5.