Adds a screen group to the display.

Err AddScreenGroup (Item screenGroup,TagArg *targs) Err AddScreenGroupVA (Item screenGroup,uint32 targs,...)

This call adds the specified screenGroup to the Graphics folio's display mechanism. After this call, the screens of the group can be made visible with a call to DisplayScreen().

• screenGroup Item number of the screenGroup to be added.

• targs Pointer to an array of tag arguments. These values control the initial display configuration of the group. The last element of the array must be the value TAG_END. For a list of tag arguments for screen group items, see Portfolio Items in the System Programmer's Reference.“

This call returns 0 if the group was added to the display, or an error code (a negative value) if an error occurs.

• GRAFFERR_SGINUSE is returned if AddScreenGroup() is called for a screenGroup that has already been added with the AddScreenGroup() call.

Folio call implemented in Graphics folio V20.

graphics.h, graphics.lib

DisplayScreen(), RemoveScreenGroup()