AddScreenGroup

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