]]>
]]>
DtEditorGoToLine
library call
DtEditorGoToLine
move the insert cursor for a DtEditor widget to a specified line
#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
&cdeman.DtEditorSetInsertionPosition;. 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
&cdeman.DtEditor;. ]]>
RETURN VALUE
The
DtEditorGoToLine function returns no value.
SEE ALSO
&cdeman.Dt.Editor.h;, &cdeman.DtEditor;, &cdeman.DtEditorSetInsertionPosition;.