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)

September 02, 1992