NAME

DgInqObjAtPos − Return the object at a specified position in a group

SYNOPSIS

C:

DtObject DgInqObjAtPos(group, offset,
                       position_orientation)
DtObject group ;
DtInt offset;
DtRelPosition position_orientation;

FORTRAN:

INTEGER∗4 DGQOP(GROUP, OFFSET, POSORT)
INTEGER∗4 GROUP
INTEGER∗4 OFFSET
INTEGER∗4 POSORT

DESCRIPTION

DgInqObjAtPos returns the object at the position, in offset, relative to the position in position_orientation, and within the group group.  Positions within a group are zero based with element 0 being the first element in the group and element n-1 being the last element in the group of size n. 

The position_orientation parameter can take 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.

If no object is at the specified position, then DcNullObject <DCNULL> is returned.  Otherwise, the object at the specified position is returned. 

ERRORS

DgInqObjAtPos will fail if called with an invalid group; the value DcNullObject <DCNULL> is returned. 

[WARNING - invalid group handle]

September 02, 1992