# AddScreenGroup

Adds a screen group to the display.

### Synopsis

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

### Description

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()`.

### Arguments

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."

### Return Value

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.

### Implementation

Folio call implemented in Graphics folio V20.

### Associated Files

graphics.h, graphics.lib

### See Also

``DisplayScreen`(), RemoveScreenGroup()`