Deletes a VDL and all its associated data structures.
Err DeleteVDL (Item vdlItem)
This macro is a convenience call to DeleteItem()
. It deletes a VDL that was created with a call to SubmitVDL()
. Any data structures and buffers allocated by SubmitVDL()
are also deleted.
After the call to this macro, the VDL item number becomes invalid. If the VDL is currently being used in a screen that's being displayed, the screen will go black.
The call returns 0 if successful or an error code (a negative value) if an error occurs.
Macro implemented in graphics.h V20.
graphics.h
DeleteScreenGroup()
does not delete VDLs that were created with the initial CreateScreenGroup()
if new VDLs have been attached to the screens with SetVDL()
. If a new VDL has been attached to a screen in the ScreenGroup being deleted with the DeleteScreenGroup()
call, then the new VDL is deleted as well.