Deletes a screen group and its associated data structures.
Err DeleteScreenGroup (Item screenGroupItem)
This call undoes what CreateScreenGroup()
does. Before release 1.3, DeleteScreenGroup()
was defined to DeleteItem()
, which was insufficient.
DeleteScreenGroup()
frees memory for bitmap items, if and only if, the memory was allocated by CreateScreenGroup()
. Screen and VDL items associated with the screenGroupItem are deleted.
The call returns 0 if successful or an error code (a negative value) if an error occurs.
If you get clever with VDLs and bitmaps, don't assume DeleteScreenGroup()
is as clever as you are. Unwind all your modifications before calling DeleteScreenGroup()
.
Convenience call implemented graphics.lib V21.
graphics.h, graphics.lib
CreateScreenGroup
()