DgInqObjAtPos(3D)

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]