home *** CD-ROM | disk | FTP | other *** search
/ ftp.wwiv.com / ftp.wwiv.com.zip / ftp.wwiv.com / pub / MISC / PBAPI10.ZIP / APIDOCS.ZIP / SCREEN.DOC < prev    next >
Text File  |  1998-02-21  |  3KB  |  81 lines
  1. Author....... : Gary Price
  2. Copyrighted by: Freejack's Software 1997-98
  3.  
  4. SCREEN API for TriBBS v10.x/11.x written in PowerBasic v3.5
  5. ---------------------------------------------------------------------------
  6.  
  7. The SCREEN unit is supplied as an effort to help programmers design better
  8. looking GUI's for their Main Program Design. The SCREEN unit is declared in
  9. PBAPI10.INC as follows:
  10.  
  11.  
  12. SUB SaveScreen(ScreenID    AS STRING, _
  13.                TopRow      AS INTEGER, _
  14.                LeftColumn  AS INTEGER, _
  15.                BottomRow   AS INTEGER, _
  16.                RightColumn AS INTEGER, _
  17.                Shadow      AS INTEGER)
  18.  
  19. SUB RestoreScreen(ScreenID AS STRING)
  20.  
  21. SUB PutSavedScreen(ScreenID   AS STRING, _
  22.                    TopRow     AS INTEGER, _
  23.                    LeftColumn AS INTEGER)
  24.  
  25. SUB POPWIND (Title       AS STRING, _
  26.              Toprow      AS INTEGER, _
  27.              Leftcolumn  AS INTEGER, _
  28.              Bottomrow   AS INTEGER, _
  29.              Rightcolumn AS INTEGER, _
  30.              Attr        AS INTEGER, _
  31.              Shadow      AS INTEGER, _
  32.              Border      AS INTEGER)
  33.  
  34. ---------------------------------------------------------------------------
  35. SUB SaveScreen(ScreenID    AS STRING, _
  36.                TopRow      AS INTEGER, _
  37.                LeftColumn  AS INTEGER, _
  38.                BottomRow   AS INTEGER, _
  39.                RightColumn AS INTEGER, _
  40.                Shadow      AS INTEGER)
  41.  
  42.  The SaveScreen sub will allow you to save a portion of your scrren just
  43.  prior to popping open another window. This will allow you to call the
  44.  Restore sub to put back the saved portion of your screen later in your
  45.  program and keep from having to rewrite a complete full screen each time.
  46.  
  47. ---------------------------------------------------------------------------
  48. SUB RestoreScreen(ScreenID AS STRING)
  49.  The RestoreScreen works along with the SaveScreen Sub. This will allow you
  50.  to bring back the saved portion of your screen after saving it back to it's
  51.  original location.
  52.  
  53. ---------------------------------------------------------------------------
  54. SUB PutSavedScreen(ScreenID   AS STRING, _
  55.                    TopRow     AS INTEGER, _
  56.                    LeftColumn AS INTEGER)
  57.  
  58.  The PutSaveScreen sub works basically like the RestoreScreen, except it will
  59.  allow you to locate and restore to a new starting x1, y1 location instead of
  60.  the orginal location it was saved from.
  61.  
  62. ---------------------------------------------------------------------------
  63. SUB POPWIND (Title       AS STRING, _
  64.              Toprow      AS INTEGER, _
  65.              Leftcolumn  AS INTEGER, _
  66.              Bottomrow   AS INTEGER, _
  67.              Rightcolumn AS INTEGER, _
  68.              Attr        AS INTEGER, _
  69.              Shadow      AS INTEGER, _
  70.              Border      AS INTEGER)
  71.  
  72.  The Popwind sub will allow you to pop open a window on top of any portion
  73.  of your main screen. Calling SaveScreen first, then Popwind, and then
  74.  RestoreScreen will give your program that windows look and feel in Dos.
  75.  
  76.  To calculate a color number for the Attr, select a color from 1 to 15, then
  77.  mulptiply x 16. If you want to do forground, then add the number of color to
  78.  the sum of the multiplied answer like so: 1 x 16 = 16 for Blue Background,
  79.  add 15 for a total of 31 to give you Blue background with White forground.
  80.  
  81.