DgOpen(3D)

NAME
DgOpen - Open a group object

SYNOPSIS
C:
void DgOpen(group, append)
DtObject group;
DtFlag append;

FORTRAN:
CALL DGO(GROUP, APPEND)
INTEGER*4 GROUP
INTEGER*4 APPEND

DESCRIPTION
DgOpen opens the group object, group. Open groups can be nested in Dore, but there can be only one active group at any given time. The active group is the most recently opened group. It is affected by any implicit DgXXXX commands, such as DgReplaceObj <DGRO> and DgAddObj <DGAO>.

If the append flag, append, is DcFalse <DCFALS>, the group's element pointer is left as it was before the group was opened. If the append flag is DcTrue <DCTRUE>, the group element pointer is placed at the end of the group so that new elements are appended to the open group.

ERRORS
DgOpen will fail if the group handle is invalid.

[WARNING - invalid group handle]

SEE ALSO
DgInqOpen(3D), DoGroup(3D), DoInLineGroup(3D)