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 Doré, 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)

September 02, 1992