NAME

DtEditorGotoLine − move the insert cursor for a DtEditor widget to a specified line

SYNOPSIS

#include <Dt/Editor.h>
void DtEditorGotoLine(Widget widget
unsigned int lineNumber);

DESCRIPTION

The DtEditorGotoLine() function moves the insert cursor for the DtEditor widget to the beginning of the line specified by lineNumber. 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. 

If lineNumber is less than one, the insert cursor is placed at the beginning of the first line.  If it 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). 
 
 

  —  3 May 1994