dteditorgetlastposition(3) [hpux man page]

DtEditorGetLastPosition(library call)									     DtEditorGetLastPosition(library call)

NAME

       DtEditorGetLastPosition -- retrieve the position of the last character in a DtEditor widget

SYNOPSIS

       #include <Dt/Editor.h>
       XmTextPosition DtEditorGetLastPosition(
       Widget widget);

DESCRIPTION

       The  DtEditorGetLastPosition function accesses the last text position in the DtEditor widget.  The position is an integer number of charac-
       ters from the beginning of the widget's buffer.	Any text added to the end of the buffer is added after this position.  The first character
       position is zero.  The last character position is equal to the number of characters contained in the widget.

       The widget argument specifies the DtEditor widget ID.

       For a complete definition of the DtEditor widget and its associated resources, see DtEditor(3).

RETURN VALUE

       Upon  successful  completion,  the DtEditorGetLastPosition function returns an XmTextPosition value that indicates the last position in the
       text; otherwise, it returns NULL.

APPLICATION USAGE

       The position information is given in terms of characters, which may differ from the byte position when multi-byte code sets are in use.

SEE ALSO

       Dt/Editor.h - DtEditor(5), DtEditor(3), DtEditorGetInsertionPosition(3), DtEditorSetInsertionPosition(3).

													     DtEditorGetLastPosition(library call)

DtEditorGoToLine(library call)											    DtEditorGoToLine(library call)

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 cur-
       sor 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

       Dt/Editor.h - DtEditor(5), DtEditor(3), DtEditorSetInsertionPosition(3).

														    DtEditorGoToLine(library call)