====== DrawScreenCels ======

Draws a list of cels (one or more) to the bitmaps of a screen.

==== Synopsis ====

''%%Err DrawScreenCels (Item screenItem,CCB *ccb)%%''

==== Description ====

DrawScreenCels traverses the list of bitmaps associated with the screen specified by the screenItem argument, calling ''%%DrawCels()%%'' for each bitmap. When this call returns, all cels are rendered into all bitmaps of the screen.

==== Arguments ====

  * **screenItem** Item number of a screen structure.

  * **ccb** Pointer to the first of one or more CCB structures.

==== Return Value ====

The call returns 0 if successful or an error code (a negative value) if an error occurs.

==== Implementation ====

Folio call implemented in Graphics folio V20. It became an SWI in Graphics folio V24.

==== Associated Files ====

graphics.h, graphics.lib

==== Notes ====

''%%DrawScreenCels()%%'' operates faster when the task or thread calling it owns bitmap, as opposed to simply calling ''%%OpenItem()%%'' on the bitmap.

==== See Also ====

''%%DrawCels%%''()