home *** CD-ROM | disk | FTP | other *** search
/ Club Amiga de Montreal - CAM / CAM_CD_1.iso / files / 432b.lha / EzLib / doc / killscreen.doc < prev    next >
Encoding:
Text File  |  1990-11-11  |  1.2 KB  |  32 lines
  1. FUNCTION  killscreen()  -  (safely) Close a previously opened screen
  2.  
  3.    killscreen(screen)
  4.      struct Screen *screen;
  5.  
  6.     This function will close the screen you pass it.  If the screen has a
  7. depth of greater than 2 (depth > 2) the bitmap data will be freed also.  If
  8. you have changed the screen->ExtData field from what it originally was
  9. just after you called makescreen(), you should put it back to the
  10. original value BEFORE you make this call.  (The ExtData field points to
  11. the BitMap structure that was allocated when creating the screen - and
  12. note: this is not the same BitMap structure that is in your Screen struct).
  13.  
  14.     If there are any windows left on the screen, this function will
  15. wait for them to go away before closing.  Note that killscreen() will
  16. keep waiting forever until the windows are gone, so make sure that any
  17. windows without close gadgets/menus on them are closed before you call
  18. this.  Else you will be in an infinite (but slow) loop.  The point
  19. here is that if you have a borderless backdrop window on a screen, and
  20. you call killscreen() - you are screwed, glued, and tatooed unless
  21. someone else closes that window for you.
  22.  
  23.  
  24. TODO : nothing
  25.  
  26. BUGS : nope.
  27.  
  28. SEE ALSO : killwindow()
  29.  
  30.  
  31.  
  32.