====== 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 [[:documentation:development:opera:pf25:ppgfldr:pgsfldr:spr:09spr#xref15850|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%%''(), [[:documentation:development:opera:pf25:ppgfldr:ggsfldr:gprfldr:01gpr052#xref35655|RemoveScreenGroup]]()