DgSetElePtr(3D)

NAME
DgSetElePtr - Set the group element pointer within the current group

SYNOPSIS
C:
void DgSetElePtr(element_ptr, position_orientation)
DtInt element_ptr;
DtRelPosition position_orientation;

FORTRAN:
CALL DGSEP(ELEPTR, POSORT)
INTEGER*4 ELEPTR
INTEGER*4 POSORT

DESCRIPTION
DgSetElePtr sets the group element pointer to the location element_ptr, relative to position orientation position_orientation, in the currently open group.

Each group has an element pointer that identifies the current editing position within the group. The element pointer points between elements of a group. A value of 0 indicates that the element pointer is pointing before the first element in the group. A value of n, where n is the current size of the group, indicates that the element pointer is pointing after the last element in the group.

The position_orientation parameter takes one of the following values:

DcBeginning <DCBEG>
    The element pointer is positioned relative to the beginning of the group.

DcEnd <DCEND>
    The element pointer is positioned relative to the end of the group.

DcCurrent <DCCUR>
    The element pointer is positioned relative to the element pointer's current position.

ERRORS
DgSetElePtr will fail if no group is currently open.

[WARNING - a group is not currently open]

SEE ALSO
DgInqElePtr(3D), DgSetElePtrRelLabel(3D)