home *** CD-ROM | disk | FTP | other *** search
/ Simtel MSDOS 1992 September / Simtel20_Sept92.cdr / msdos / turbo_c / prowintc.arc / PROWINDC.DOC < prev    next >
Text File  |  1988-10-03  |  31KB  |  991 lines
  1.  
  2.  
  3.                          ProWindows *LITE* - Version 2.00TC
  4.                                     Documentation
  5.  
  6.  
  7.          General Requirements:
  8.  
  9.               Hardware - IBM PC, PC/XT, AT, or Compatible Computer
  10.                          Mono, CGA, and EGA (in CGA mode)
  11.                          1 Disk Drive
  12.                          512K RAM minimum
  13.                          DOS 2.1 or higher
  14.  
  15.  
  16.               Pro. Version   Required Software        Version
  17.  
  18.               2.00TC         Borland Turbo C          1.5 or higher
  19.               2.00TP         Borland Turbo Pascal     4.0 or higher
  20.               2.00QB         Microsoft QuickBASIC     4.0 or higher
  21.  
  22.  
  23.  
  24.                               ***** LEGAL NOTICE *****
  25.  
  26.               This documentation, it's accompanying source code, header
  27.          files, and executable code is copyrighted by Daniel P. Stasinski.
  28.          You are hereby granted a 30 day trial period to evaluate this
  29.          package, after which you are required to pay a registration fee to
  30.          obtain a license to use this package.
  31.  
  32.               If after 30 days you decide that this package does not
  33.          fulfill your present needs, you are required, by law, to remove it
  34.          from your possession.
  35.  
  36.               You are permitted to distribute this package by any means you
  37.          deem fit, to any persons you deem fit.  But you are specifically
  38.          prohibited from charging any type of fee, implied or actual, for
  39.          this distribution without written consent from this author.
  40.  
  41.               You are prohibited from making any modifications, to the
  42.          ProWindows *LITE* library, object code, header files, or
  43.          documentation.  All copyright notices must remain intact in each
  44.          of these files.
  45.  
  46.  
  47.  
  48.  
  49.  
  50.  
  51.  
  52.  
  53.  
  54.  
  55.  
  56.  
  57.  
  58.  
  59.  
  60.  
  61.  
  62.  
  63.                        (c) Copyright 1988  Daniel P. Stasinski
  64.  
  65.  
  66.  
  67.  
  68.  
  69.                          ProWindows *LITE* - Version 2.00TC
  70.                                     Documentation
  71.  
  72.  
  73.                                 SUPPORTING THE AUTHOR
  74.                                 ---------------------
  75.  
  76.                         The 'User Supported Software' Concept
  77.  
  78.               'User Supported Software' means exactly that.  If you like
  79.          this product, and use it, then you should pay for it.  If you do
  80.          not like it, then you are to delete it from your files, or pass it
  81.          along to a friend.  By supporting the efforts of this author, he
  82.          is allowed to spend his time enhancing this product to make it
  83.          better for you, the end user.
  84.  
  85.               This product is no different.  If you keep it and/or use it,
  86.          you must send in the registration and license fee of $7.50
  87.          (American dollars) to:
  88.  
  89.                                  Daniel P. Stasinski
  90.                                    30 North Street
  91.                                   Willits, CA 95490
  92.  
  93.               An obtained license grants you full permission to use
  94.          ProWindows *LITE* in any public domain, ShareWare, commercial, or
  95.          user software, that you develop.  THERE ARE NO ADDITIONAL
  96.          ROYALTIES.
  97.  
  98.               For $15.00 (American dollars) you can obtain the same
  99.          license, plus ProWindows *LITE* - Version 3.00.
  100.  
  101.               Version 3.00 has 30 additional window styles, is faster, and
  102.          can produce considerably smaller executable files.  It also comes
  103.          with a certificate for a $10.00 discount on ProWindows *PLUS*, the
  104.          most advanced "Software Development System" that is currently
  105.          available.
  106.  
  107.                                 THE AUTHOR SUPPORTING YOU
  108.                                 -------------------------
  109.  
  110.               Registered users are offered almost unlimited support.  If
  111.          you need assistance, just mail a letter to the above address and I
  112.          will respond as fast as humanly possible.
  113.  
  114.               If you are not a registered user, please write and tell me
  115.          why.  It is possible I can enhance this product so that you will
  116.          want to register.  Send me your suggestions.
  117.  
  118.               If you discover a bug (I hope there are none), report it
  119.          immediately and it will be corrected immediately.
  120.  
  121.                                     PHONE SUPPORT
  122.                                     -------------
  123.  
  124.               As demand grows, I will be adding a telephone support line
  125.               for all of my software products.  When this becomes
  126.               available, all registered users will receive a notice.
  127.  
  128.  
  129.                        (c) Copyright 1988  Daniel P. Stasinski
  130.  
  131.  
  132.  
  133.  
  134.  
  135.                          ProWindows *LITE* - Version 2.00TC
  136.                                     Documentation
  137.  
  138.  
  139.             ┌───────────────────────────────────────────────────────────┐
  140.             │  F O R    T H E   S E R I O U S    P R O G R A M M E R S  │
  141.             └───────────────────────────────────────────────────────────┘
  142.  
  143.                   >>>>>>>>>> AVAILABLE OCTOBER 15, 1988 <<<<<<<<<<
  144.  
  145.                          ProWindows *PLUS* and 'ProDesigner'
  146.                           only $34.95 for the dual package
  147.  
  148.  
  149.               ProWindows *PLUS* is the ultimate professional "Software
  150.          Development System".  It adds dozens of new, and many enhancements
  151.          to the existing ProWindows *LITE* routines.
  152.  
  153.          NEW *PLUS* routines include:
  154.  
  155.               PopHelp - Instant Full Color Help Screens.
  156.               PopMenu - vertical or horizontal menus.
  157.               PopList  - vertical or horizontal scrolling menus.
  158.               PullMenu - pull down (QB style) menus.
  159.               GridMenu - X-Y grid list with scrolling.
  160.               PopCalander - instant calanders with date highlight.
  161.               PopCalc - pop up calculator with tape and paste.
  162.               PopAdd - pop up adding machine with tape and paste.
  163.               StopWatch - up to 255 separate event timers.
  164.               FillScreen - fills the screen with pattern and color.
  165.               Validate - multi-answer validator.
  166.               Query - Single line entry editor.
  167.               GetColor - Custom color coordinator.
  168.  
  169.               and much much more...........
  170.  
  171.               When using "ProDesigner", creating all type of menu's, entry
  172.          screens, and help screens is a snap.  You use the "ProDesigner"
  173.          easy to use "Menu Editor" to create or modify each of your menus.
  174.          Then you use the "Help Editor" to create FULL COLOR, single or
  175.          multi page, help screens which can correspond to ANY menu
  176.          selections, or can be made to appear instantly anywhere in your
  177.          program.
  178.  
  179.               "ProDesigner" can also generate most of the support source
  180.          code for each of these functions.
  181.  
  182.                  **********  I M P O R T A N T   N O T E  **********
  183.                  **********  I M P O R T A N T   N O T E  **********
  184.  
  185.               "ProDesigner" IS NOT A SIMPLE SOURCE CODE GENERATOR, unlike
  186.          all other screen design programs.  This software uses very
  187.          advanced techniques that grab entire screens and compress them up
  188.          to 90%.  These routines are so fast that you can display 25 (yes
  189.          25) full page screens in less than 1 second.
  190.  
  191.                  **********  I M P O R T A N T   N O T E  **********
  192.                  **********  I M P O R T A N T   N O T E  **********
  193.  
  194.  
  195.                        (c) Copyright 1988  Daniel P. Stasinski
  196.  
  197.  
  198.  
  199.  
  200.  
  201.                          ProWindows *LITE* - Version 2.00TC
  202.                                     Documentation
  203.  
  204.  
  205.                            ***** Method of Operation *****
  206.  
  207.          ProWindows *LITE* & *PLUS* is more than just a windowing module,
  208.          in a way, it is more like a special operating system.  Both of
  209.          these packages are based upon the "PRO-WLS" (Professional Window
  210.          Logic System) unit.  The "PRO-WLS" unit manages every function
  211.          used to create, print to, clear, and finally, remove a window.
  212.  
  213.          When you call the 'popwindow' function, many important procedures
  214.          take place.  First, "PRO-WLS" saves the portion of the current
  215.          screen you are about to place the window over.  Then, using a
  216.          proprietary compression algorithm, the old screen is squeezed to
  217.          sometimes less that 80% it's original size.  This is intended to
  218.          save you plenty of memory space.  Also, your compressed screen is
  219.          stored in 'far' memory so you will save that valuable 'string
  220.          space' too.
  221.  
  222.          After compression, every parameter you gave 'popwindow' is placed
  223.          onto the window stack.  The window stack is used to tell the other
  224.          ProWindows functions where and how they can place text within the
  225.          intended screen.  In addition, it also holds vital information as
  226.          to how your old screen is to be decompressed and redisplayed when
  227.          you call the 'removewindow' function.  This version comes with a
  228.          default stack that can hold up to 25 simultaneous windows.  The
  229.          registered version can display 100 simultaneous windows.
  230.  
  231.          All this happens in about 1/20th of a second.
  232.  
  233.          When you call the 'removewindow' function, the exact opposite
  234.          happens.  The "PRO-WLS" unit locates your old screen, decompresses
  235.          it, and places it back on your current screen, and at the correct
  236.          location too.  Cleanup procedures automaticly free the memory
  237.          where your window was stored.  Never is a byte wasted.
  238.  
  239.          Nothing could be easier.
  240.  
  241.  
  242.  
  243.  
  244.  
  245.  
  246.  
  247.  
  248.  
  249.  
  250.  
  251.  
  252.  
  253.  
  254.  
  255.  
  256.  
  257.  
  258.  
  259.  
  260.  
  261.                        (c) Copyright 1988  Daniel P. Stasinski
  262.  
  263.  
  264.  
  265.  
  266.  
  267.                          ProWindows *LITE* - Version 2.00TC
  268.                                     Documentation
  269.  
  270.  
  271.                              ***** Data Structures *****
  272.  
  273.          There is only one data structure in use by ProWindows *LITE*.
  274.  
  275.               struct {
  276.                    int  row;
  277.                    int  col;
  278.                    int  rows;
  279.                    int  cols;
  280.                    int  attribute;
  281.                    int  border;
  282.                    int  shadow;
  283.                    int  zoom;
  284.                    char far *data;
  285.                    int  abytes;
  286.                    int  cbytes;
  287.               } wcb;
  288.  
  289.          The wcb structure is used by every ProWindows *LITE* function to
  290.          coordinate saving, printing to, and removing windows.
  291.  
  292.          The first eight elements contain the information just as you
  293.          called 'popwindow'.
  294.  
  295.          'data' is a far pointer to the memory location where your old
  296.          window is stored.  'abytes' and 'cbytes' contain specific
  297.          information as to the proper methods of decompressing your old
  298.          screen.
  299.  
  300.          Your routines must not modify the contents of any variable in this
  301.          structure.  Doing so will cause unexpected results.
  302.  
  303.  
  304.  
  305.  
  306.  
  307.  
  308.  
  309.  
  310.  
  311.  
  312.  
  313.  
  314.  
  315.  
  316.  
  317.  
  318.  
  319.  
  320.  
  321.  
  322.  
  323.  
  324.  
  325.  
  326.  
  327.                        (c) Copyright 1988  Daniel P. Stasinski
  328.  
  329.  
  330.  
  331.  
  332.  
  333.                          ProWindows *LITE* - Version 2.00TC
  334.                                     Documentation
  335.  
  336.  
  337.                             ***** GLOBAL VARIABLES *****
  338.  
  339.          -----------------------------------------------------------------
  340.          CREATEMODE
  341.          -----------------------------------------------------------------
  342.  
  343.          Name:          CREATEMODE - display window reference number flag
  344.  
  345.          Usage:         extern int CREATEMODE = 1;
  346.  
  347.          Declared in:   prowindc.h
  348.  
  349.          Desc:          'CREATEMODE' controls whether ProWindows will
  350.                         display the current window reference number at the
  351.                         lower right portion of the screen.
  352.  
  353.                         The default CREATEMODE = 1 to display reference
  354.                         numbers.
  355.  
  356.          -----------------------------------------------------------------
  357.          WI
  358.          -----------------------------------------------------------------
  359.  
  360.          Name:          WI - index to current window
  361.  
  362.          Usage:         extern int WI;
  363.  
  364.          Declared in:   prowindc.h
  365.  
  366.          Desc:          'WI' contains an integer value corresponding to the
  367.                         current window number being displayed.
  368.  
  369.                         The program must never modify the contents of this
  370.                         variable.
  371.  
  372.          -----------------------------------------------------------------
  373.          SCREEN_MODE
  374.          -----------------------------------------------------------------
  375.  
  376.          Name:          SCREEN_MODE - current video adapter mode
  377.  
  378.          Usage:         extern int SCREEN_MODE;
  379.  
  380.          Declared in:   prowindc.h
  381.  
  382.          Desc:          'SCREEN_MODE' contains the value to the current
  383.                         video mode.
  384.  
  385.                         0x02   V_BW80       80 * 25 b/w text
  386.                         0x03   V_CO80       80 * 25 color text
  387.                         0x07   V_MONO       80 * 25 mono text
  388.                         0xff   V_INVALID    Not a supported video mode
  389.  
  390.  
  391.  
  392.  
  393.                        (c) Copyright 1988  Daniel P. Stasinski
  394.  
  395.  
  396.  
  397.  
  398.  
  399.                          ProWindows *LITE* - Version 2.00TC
  400.                                     Documentation
  401.  
  402.  
  403.                              ***** ERROR HANDLING *****
  404.  
  405.          ProWindows *LITE*, by design, is a very delicate system.  It's
  406.          error handling procedures were designed so that in the event of a
  407.          major error, the program terminates.  As you may realize, this
  408.          forces you to write programs with special attention to accuracy.
  409.  
  410.          When a fatal occurs, an error message is displayed, and the Turbo
  411.          C 'exit(int error)' function is called, with the ProWindows *LITE*
  412.          'error number as the argument.
  413.  
  414.          Possible errors are:
  415.  
  416.               1 - ProWindows *LITE* not initialized.
  417.               2 - Memory allocation error.
  418.               3 - Not enough memory in far heap.
  419.               4 - No window to remove.
  420.               5 - Too many windows.
  421.               6 - Not a supported video mode.
  422.               9 - Invalid copyright.
  423.  
  424.          Error 1 is a result of the failure to call 'initpro' prior to
  425.          creating a pop up window.  Simply stated, if you do not call this
  426.          feature, you can not create windows.
  427.  
  428.          Error 2 will probably result if there is not enough memory while
  429.          the ProWindows WLS (Window Logic System) is storing or restoring
  430.          a screen.
  431.  
  432.          Error 3 is invoked when you do not have enough memory in the far
  433.          heap.  As a rule, ProWindows requests an average 400 bytes per
  434.          window.
  435.  
  436.          Error 4 means that you have tried to delete more windows than you
  437.          have displayed.
  438.  
  439.          Error 5 occurs if you attempt to create more windows than is
  440.          permitted for your version.
  441.  
  442.          Error 5 occurs if you attempt to display or remove a window while
  443.          in a graphics mode.
  444.  
  445.          Error 9 is important.  If this ever occurs, you have committed a
  446.          very serious crime.  Intentionally altering or removing a
  447.          copyright from a product is a federal crime and is punishable with
  448.          a $10,000 fine and 5 years in prison.  Please do not ever degrade
  449.          yourself by modifying the copyright.
  450.  
  451.  
  452.  
  453.  
  454.  
  455.  
  456.  
  457.  
  458.  
  459.                        (c) Copyright 1988  Daniel P. Stasinski
  460.  
  461.  
  462.  
  463.  
  464.  
  465.                          ProWindows *LITE* - Version 2.00TC
  466.                                     Documentation
  467.  
  468.  
  469.          -----------------------------------------------------------------
  470.          initpro
  471.          -----------------------------------------------------------------
  472.  
  473.          Name:          initpro - initialize ProWindows *LITE*
  474.  
  475.          Usage:         #include <prowindc.h>
  476.                         void pascal initpro(int row, int col,
  477.                                             void pascal (*userscreen)(),
  478.                                             int snowcheck);
  479.  
  480.          Desc:          This function initializes the ProWindows *LITE*
  481.                         package, sets up global variables, and displays the
  482.                         default copyright window.  ProWindows specific
  483.                         functions can not be used until initialized.
  484.  
  485.                         You may not create popup windows before
  486.                         initializing but you may create a type void pascal
  487.                         function that contains the code you need to create
  488.                         your startup screen.  Upon exiting this function,
  489.                         the default ProWindows copyright message is
  490.                         displayed at the coordinates 'row' and 'col', and
  491.                         execution is paused for 3 seconds.  You may then
  492.                         remove the copyright message and/or your startup
  493.                         screens.  (Note: Version 3.00 users are not
  494.                         required to display the ProWindows copyright
  495.                         message, and have the option to disable it along
  496.                         with the 3 second delay).
  497.  
  498.                         The final parameter, snowcheck, determines whether
  499.                         the windows will suppress snow on old or sloppy CGA
  500.                         cards.  You might want to make this an option in
  501.                         your end program since most new CGA cards
  502.                         automatically suppress snow.  Snow checking
  503.                         minutely decreases window speed.
  504.  
  505.          Example:
  506.  
  507.          #include <prowindc.h>
  508.  
  509.          void pascal userscreen()
  510.          {
  511.               popwindow(5, 5, 15, 70, attr(15, 1), 1, 0, 1);
  512.               titlewindow(2, "[ My fantastic program ]");
  513.          }
  514.  
  515.          void main()
  516.          {
  517.               initpro(8, 20, userscreen, 0);
  518.               removewindow();          /* first the copyright */
  519.               removewindow();          /* then your screen    */
  520.          }
  521.  
  522.  
  523.  
  524.  
  525.                        (c) Copyright 1988  Daniel P. Stasinski
  526.  
  527.  
  528.  
  529.  
  530.  
  531.                          ProWindows *LITE* - Version 2.00TC
  532.                                     Documentation
  533.  
  534.  
  535.          -----------------------------------------------------------------
  536.          attr
  537.          -----------------------------------------------------------------
  538.  
  539.          Name:     attr - video attribute calculator
  540.  
  541.          Usage:    #include <prowindc.h>
  542.                    int pascal(int foreground, int background);
  543.  
  544.          Desc:     Returns an integer as a video attributes.  Valid
  545.                    foreground ranges are 0 to 31.  Valid background ranges
  546.                    are 0 to 7.
  547.  
  548.                    This function is used with most ProWindows *LITE* &
  549.                    *PLUS* routines.
  550.  
  551.          Example:
  552.  
  553.          #include <prowindc.h>
  554.          #include <stdio.h>
  555.  
  556.          void main()
  557.          {
  558.               int color;
  559.  
  560.               color = attr( 15, 1);    /* Highlight White on Blue */
  561.  
  562.               printf("The attribute is : %3d\n", color);
  563.          }
  564.  
  565.  
  566.  
  567.  
  568.  
  569.  
  570.  
  571.  
  572.  
  573.  
  574.  
  575.  
  576.  
  577.  
  578.  
  579.  
  580.  
  581.  
  582.  
  583.  
  584.  
  585.  
  586.  
  587.  
  588.  
  589.  
  590.  
  591.                        (c) Copyright 1988  Daniel P. Stasinski
  592.  
  593.  
  594.  
  595.  
  596.  
  597.                          ProWindows *LITE* - Version 2.00TC
  598.                                     Documentation
  599.  
  600.  
  601.          -----------------------------------------------------------------
  602.          popwindow
  603.          -----------------------------------------------------------------
  604.  
  605.          Name:          popwindow - create a user defined window
  606.  
  607.          Usage:         #include <prowindc.h>
  608.                         void pascal popwindow(int row, int col,
  609.                                               int rows, int cols,
  610.                                               int attribute,
  611.                                               int border, int shadow,
  612.                                               int zoom);
  613.  
  614.          Desc:          Each displayed window begins at coordinates 'row',
  615.                         'col', and is 'rows' deep and 'cols' wide.
  616.                         'attribute' determines the window's color.
  617.  
  618.                              5 'border' styles,
  619.  
  620.                                   0 - No Border
  621.                                   1 - Single line box
  622.                                   2 - Double line box
  623.                                   3 - Single Horizontal - Double Vertical
  624.                                   4 - Double Horizontal - Single Vertical
  625.                                   5 to 15 - Version 3.00 only
  626.  
  627.                              2 'Shadow%' styles,
  628.  
  629.                                   0 - No Shadow
  630.                                   1 - Bottom Left
  631.                                   2 to 4 - Version 3.00 only
  632.  
  633.                              2 'Zoom%' styles,
  634.  
  635.                                   0 - No Zoom (Instant)
  636.                                   1 - Grow from Center
  637.                                   2 to 9 - Version 2.5 only
  638.  
  639.                         Prior to displaying each window, the current
  640.                         portion of screen which the window will occupy is
  641.                         automatically stored.
  642.  
  643.          Warning:       DO NOT EVER USE 'attr(8, 0)'.  This particular
  644.                         attribute generates a code that will completely
  645.                         corrupt the screen compression routine and will
  646.                         cause your computer to lock up.  Since those two in
  647.                         combination create black on black, you should never
  648.                         have a reason to use them.
  649.  
  650.          See Also:      attr, initpro, removewindow
  651.  
  652.  
  653.  
  654.  
  655.  
  656.  
  657.                        (c) Copyright 1988  Daniel P. Stasinski
  658.  
  659.  
  660.  
  661.  
  662.  
  663.                          ProWindows *LITE* - Version 2.00TC
  664.                                     Documentation
  665.  
  666.  
  667.          Example:
  668.  
  669.          #include <prowindc.h>
  670.  
  671.          void pascal userscreen()
  672.          {
  673.               popwindow(5, 5, 15, 70, attr(15, 1), 1, 0, 1);
  674.               titlewindow(2, "[ My fantastic program ]");
  675.          }
  676.  
  677.          void main()
  678.          {
  679.               int x;
  680.  
  681.               initpro(8, 20, userscreen, 0);
  682.               removewindow();          /* the copyright */
  683.  
  684.               for(x = 1; x <= 15; x++)
  685.                    popwindow(x, x * 4, 5, 10, attr(x, 4), 1, 1, 1);
  686.  
  687.               delay(1500);
  688.  
  689.               for(x = 1; x <= 15; x++)
  690.                    removewindow();
  691.          }
  692.  
  693.  
  694.  
  695.  
  696.  
  697.  
  698.  
  699.  
  700.  
  701.  
  702.  
  703.  
  704.  
  705.  
  706.  
  707.  
  708.  
  709.  
  710.  
  711.  
  712.  
  713.  
  714.  
  715.  
  716.  
  717.  
  718.  
  719.  
  720.  
  721.  
  722.  
  723.                        (c) Copyright 1988  Daniel P. Stasinski
  724.  
  725.  
  726.  
  727.  
  728.  
  729.                          ProWindows *LITE* - Version 2.00TC
  730.                                     Documentation
  731.  
  732.  
  733.          -----------------------------------------------------------------
  734.          titlewindow
  735.          -----------------------------------------------------------------
  736.  
  737.          Name:          titlewindow - titles the current window
  738.  
  739.          Usage:         #include <prowindc.h>
  740.                         void pascal titlewindow(int location, char *text);
  741.  
  742.          Desc:          Places specified text at any of six border
  743.                         locations in the current window.  Foreground and
  744.                         background colors are set to the default for that
  745.                         particular window.  Multiple calls are allowed, so
  746.                         you may places text at all six locations if you
  747.                         desire.
  748.  
  749.                              Border positions permitted:
  750.  
  751.                                   1 - Top Left.
  752.                                   2 - Top Center.
  753.                                   3 - Top Right
  754.                                   4 - Bottom Left.
  755.                                   5 - Bottom Center.
  756.                                   6 - Bottom Right.
  757.                                   7 - Vertical Left - Version 3.00 only
  758.                                   8 - Vertical Right - Version 3.00 only
  759.  
  760.          Example:
  761.  
  762.          #include <prowindc.h>
  763.  
  764.          void pascal userscreen()
  765.          {
  766.               int location;
  767.  
  768.               popwindow(5, 5, 15, 70, attr(15, 1), 1, 0, 1);
  769.  
  770.               for(location = 1; location <= 6; location++)
  771.                    titlewindow(location, "[ Title ]");
  772.          }
  773.  
  774.          void main()
  775.          {
  776.               initpro(8, 20, userscreen, 0);
  777.               removewindow();          /* the copyright */
  778.               removewindow();          /* your screen */
  779.          }
  780.  
  781.  
  782.  
  783.  
  784.  
  785.  
  786.  
  787.  
  788.  
  789.                        (c) Copyright 1988  Daniel P. Stasinski
  790.  
  791.  
  792.  
  793.  
  794.  
  795.                          ProWindows *LITE* - Version 2.00TC
  796.                                     Documentation
  797.  
  798.  
  799.          -----------------------------------------------------------------
  800.          clearwindow
  801.          -----------------------------------------------------------------
  802.  
  803.          Name:          clearwindow - clears contents of current window
  804.  
  805.          Usage:         #include <prowindc.h>
  806.                         void pascal clearwindow();
  807.  
  808.          Desc:          Clears out entire contents of the current window.
  809.                         Does not remove the border or any titles or text
  810.                         on window borders.
  811.  
  812.          See Also:      RemoveWindow
  813.  
  814.          Example:
  815.  
  816.          #include <prowindc.h>
  817.  
  818.          void pascal userscreen()
  819.          {
  820.               int location;
  821.  
  822.               popwindow(5, 5, 15, 70, attr(15, 1), 1, 0, 1);
  823.  
  824.               for(location = 1; location <= 6; location++)
  825.                    titlewindow(location, "[ Title ]");
  826.  
  827.               wprint(3, 3, "Some Text");
  828.               wprint(7, 5, "More Text");
  829.          }
  830.  
  831.          void main()
  832.          {
  833.               initpro(8, 20, userscreen, 0);
  834.               removewindow();          /* the copyright only */
  835.  
  836.               clearwindow();           /* window from userscreen() */
  837.  
  838.               delay(1000);
  839.  
  840.               wprint( 4, 2, "This Text");
  841.               wprint( 8, 9, "That Text");
  842.  
  843.               delay(1000);
  844.  
  845.               removewindow();
  846.          }
  847.  
  848.  
  849.  
  850.  
  851.  
  852.  
  853.  
  854.  
  855.                        (c) Copyright 1988  Daniel P. Stasinski
  856.  
  857.  
  858.  
  859.  
  860.  
  861.                          ProWindows *LITE* - Version 2.00TC
  862.                                     Documentation
  863.  
  864.  
  865.          -----------------------------------------------------------------
  866.          removewindow
  867.          -----------------------------------------------------------------
  868.  
  869.          Name:          removewindow - removes the current window
  870.  
  871.          Usage:         #include <prowindc.h>
  872.                         void pascal removewindow();
  873.  
  874.          Desc:          Removes current window being displayed and restores
  875.                         the screen back to its original contents.
  876.  
  877.                         Displays an error message and exits with exit code
  878.                         4 if no windows are none on the stack.
  879.  
  880.          See Also:      PopWindow
  881.  
  882.          Example:
  883.  
  884.          #include <prowindc.h>
  885.  
  886.          void pascal userscreen()
  887.          {
  888.               /* Does nothing but needs to be here */
  889.          }
  890.  
  891.          void main()
  892.          {
  893.               initpro(8, 20, userscreen, 0);
  894.               removewindow();          /* the copyright only */
  895.  
  896.               popwindow(5, 30, 10, 30, attr(14 ,4), 1, 1, 1);
  897.               titlewindow 5, "[ One moment please... ]");
  898.  
  899.               delay(1000);
  900.  
  901.               removewindow();
  902.          }
  903.  
  904.  
  905.  
  906.  
  907.  
  908.  
  909.  
  910.  
  911.  
  912.  
  913.  
  914.  
  915.  
  916.  
  917.  
  918.  
  919.  
  920.  
  921.                        (c) Copyright 1988  Daniel P. Stasinski
  922.  
  923.  
  924.  
  925.  
  926.  
  927.                          ProWindows *LITE* - Version 2.00TC
  928.                                     Documentation
  929.  
  930.  
  931.          -----------------------------------------------------------------
  932.          wprint
  933.          cwprint
  934.          wcprint
  935.          cwcprint
  936.          -----------------------------------------------------------------
  937.  
  938.          Name:          wprint - default color text in window
  939.                         cwprint - custom color text in window
  940.                         wcprint - default color text in window center
  941.                         cwcprint - custom color text in window
  942.  
  943.          Usage:         #include <prowindc.h>
  944.                         wprint(int row, int col, char *text);
  945.                         cwprint(int row, int col, int attr, char *text);
  946.                         wcprint(int row, char *text);
  947.                         cwcprint(int row, int attr, char *text);
  948.  
  949.          Desc:          Places text at the specified position relative to
  950.                         the inner coordinates of the current window.
  951.  
  952.                         'wprint' assumes that the text is to be displayed
  953.                         in the default colors for that window.  'cwprint'
  954.                         allows you to specify exact colors.  These routines
  955.                         are meant to be your first choice option of
  956.                         printing text to your window, the following two are
  957.                         supplied as supplementary routines only.
  958.  
  959.                         'wcprint' and 'cwcprint' are the same except that
  960.                         the text is automatically centered within the
  961.                         current window so you need not specify a column.
  962.  
  963.          Example:
  964.  
  965.          #include <prowindc.h>
  966.  
  967.          void pascal userscreen()
  968.          { /* Does nothing but needs to be here */ }
  969.  
  970.          void main()
  971.          {
  972.               initpro(8, 20, userscreen, 0);
  973.               removewindow();          /* the copyright only */
  974.  
  975.               popwindow(5, 30, 10, 30, attr(14 ,4), 1, 1, 1);
  976.               titlewindow 2, "[ Here is a title ]");
  977.               wprint(3, 5, "Default Color Text");
  978.               cwprint(4, 5, attr(15, 1), "Different Color Text");
  979.               wcprint(5, "Default Color Centered Text");
  980.               cwcprint(6, attr(15, 5), "Different Color Centered Text");
  981.  
  982.               delay(5000);
  983.               removewindow();
  984.          }
  985.  
  986.  
  987.                        (c) Copyright 1988  Daniel P. Stasinski
  988.  
  989.  
  990.  
  991.