home *** CD-ROM | disk | FTP | other *** search
/ The C Users' Group Library 1994 August / wc-cdrom-cusersgrouplibrary-1994-08.iso / vol_200 / 272_01 / dispbox.doc < prev    next >
Text File  |  1987-07-10  |  2KB  |  46 lines
  1.  
  2.  
  3.         NAME
  4.                 disp_box -- display a box on the screen
  5.  
  6.         SYNOPSIS
  7.                 void disp_box(row, col, width, height, style);
  8.                 int row, col;       position to display upper left corner
  9.                 int height, width;  size of box
  10.                 int style;          0 = single line, 1 = double line,
  11.                                     2 = single line reverse video,
  12.                                     3 = double line reverse video
  13.  
  14.  
  15.         DESCRIPTION
  16.         This function uses the features of Datalight's display
  17.         package functions, and therefore, must follow the rules
  18.         laid down by Datalight for their use.  Specifically,
  19.         disp_open() must be called prior to using this function,
  20.         and the functions may fail of the target system is not a
  21.         very close compatible since direct memory writing is being
  22.         used.  disp_box places a single line or double line box on the
  23.         screen with the upper left corner anchored at "row" and "column",
  24.         with the size denoted by the "height" and "width" values.
  25.         No error checking is done on any value.  Invalid values may have
  26.         unpredictable results.
  27.  
  28.  
  29.         EXAMPLE
  30.  
  31.               int i;
  32.               disp_open();    /* initialize the package */
  33.               disp_cls();     /* clear the screen */
  34.               disp_box(0, 0, 80, 24, 1); /* border the entire screen */
  35.                                          /* with double graphics line */
  36.  
  37.  
  38.  
  39.         CAVEAT:
  40.               if a color attribute has been set before this call,
  41.               it will revert to black & white if the "reverse video"
  42.               outlines are selected.  The attribute is not changed
  43.               for the normal video border selections.
  44.  
  45.         This function is found in SMDLx.LIB for the Datalight Compiler
  46.