DtEditorGoToLine(3UNIX System V (1 August 1995DtEditorGoToLine(3)
NAME
DtEditorGoToLine - move the insert cursor for a DtEditor
widget to a specified line
SYNOPSIS
#include <Dt/Editor.h>
void DtEditorGoToLine(Widget widget
int lineNumber);
DESCRIPTION
The DtEditorGoToLine() function moves the insert cursor for
the DtEditor widget to the beginning of the line specified
by the lineNumber argument. The cursor can be moved to the
last line by specifying DtEDITOR_LAST_LINE as the line
number. If the line is not currently on-screen, the
contents for the DtEditor widget are scrolled to display the
new insertion position.
The lineNumber argument is the number of the line in the
file, counting from 1. If the lineNumber argument is less
than 1, the insert cursor is placed at the beginning of the
first line. If the argument is greater than the total
number of lines, the cursor is placed at the last line of
text.
The insert cursor can be moved to a specific character
position with DtEditorSetInsertionPosition(3). The
DtNtopCharacter resource can be used to control which line
is displayed at the top of the DtEditor widget.
The widget argument specifies the DtEditor widget ID.
The lineNumber argument specifies the line number within the
DtEditor widget.
For a complete definition of the DtEditor widget and its
associated resources, see DtEditor(3).
RETURN VALUE
The DtEditorGoToLine() function returns no value.
SEE ALSO
DtEditor(5), DtEditor(3), DtEditorSetInsertionPosition(3).
Page 1 (printed 9/3/04)
