home *** CD-ROM | disk | FTP | other *** search
/ Simtel MSDOS 1992 June / SIMTEL_0692.cdr / msdos / desqview / api_exam.arc / README.1ST < prev    next >
Text File  |  1988-10-11  |  5KB  |  115 lines
  1.          Explaination of the DESQview API Demo programs
  2.  
  3. The DESQview API demo programs are a set of demonstration 
  4. programs that come with the DESQview API toolkits.  They 
  5. demonstration of some of the API functions available in the 
  6. DESQview API.  If you are a programmer, they should give you an 
  7. idea of some of the things that can be done with the API and what 
  8. it takes to accomplish the task.
  9.  
  10. If you are not a programmer, but a DESQview user, you might find 
  11. them amusing, but be aware that they do not form any useful 
  12. application (other than API instruction).
  13.  
  14. The example programs:
  15.  
  16. EXAMPLES -  Serves as the front end for the demonstration 
  17. programs.  Displays a menu listing the examples programs and 
  18. starts an example as a new process when so requested.  Reads a 
  19. DESQview Program Information file (DVP) from disk.  Adjust the 
  20. DVP to reflect the current drive and directory.  Starts a new 
  21. process using the DVP.
  22.  
  23. HELLO - Shows how to write a "minimal" DESQview-specific program.  
  24. It detects the presence and version number of DESQview, and exits 
  25. if DESQview is not present.  If DESQview is present, it prints 
  26. "Hello world" to the task window via the DESQview interface.
  27.  
  28. FRUIT - Displays a "pop-up" menu and reports selections from that 
  29. menu.  Creates a new window and associated keyboard, moves and 
  30. displays the window.  Sets up a menu field table and takes input 
  31. from the user via the keyboard or mouse.
  32.  
  33. POINT - Creates and reads a pointer object.  Forces the keyboard 
  34. mouse ON if you have no external mouse.
  35.  
  36. WASHER - Emulates a washing machine control panel.  Constructs 
  37. a complex menu (dialogue box) including select, input, output and 
  38. inactive fields.  Changes field types dynamically.  Implements 
  39. "radio button" select fields.  Uses a timer object to measure 
  40. time intervals.  Establishes an OBJECTQ to wait for multiple 
  41. events.
  42.  
  43. SNAKES - Displays multiple "snakes" each controlled by a separate 
  44. task.  Creates and terminates subtasks (threads).  Uses mail to 
  45. send initial data to a new task.  Uses semaphores to control 
  46. access to a resource, in this case the window.  Reads and writes 
  47. the window contents.
  48.  
  49. SERVER - Provides a very simple file management service.  It 
  50. maintains a database consisting of arbitrary length text strings 
  51. and allows the database to be queried for all records containing 
  52. a specified substring.  Queries are sent by mail from REQUEST 
  53. windows.  The results are returned to the REQUESTers mailbox.  It 
  54. uses named mailboxes to detect multiple instances of the same 
  55. program.  Uses named mailboxes to control access to public 
  56. utilities.  Sends and receives mail.  Uses a timer object to 
  57. display a running clock.
  58.  
  59. REQUEST - Provides a front-end for the SERVER program.  Takes a 
  60. string entered by the user and sends requests to the SERVER to 
  61. either add the string to the database or find all records that
  62. contain the string.  Shows how to find a named mailbox, read a 
  63. key-at-a-time from the keyboard.  Uses an asynchronous notify 
  64. function to detect attempts to close the window.
  65.  
  66. The documentation files:
  67.  
  68. README.1ST - The file you are now reading.  We hope you read it 
  69. first, but you apparently got around to it eventually.
  70.  
  71. API.DOC - Gives an overview of the DESQview API.  Explains what 
  72. the DESQview API is and gives some examples of how your programs 
  73. can make use of it.
  74.  
  75. ASSEMBLY.DOC - Gives some general background on the DESQview API 
  76. and lists the interface calls available in the assembly language 
  77. calls available in the DESQview API.
  78.  
  79. C.DOC - A listing of the "C" language calls supported by the 
  80. DESQview API C Library.
  81.  
  82. PASCAL.DOC - A listing of the Turbo Pascal language calls 
  83. supported by the DESQview API Pascal Library.
  84.  
  85. The source code:
  86.  
  87. HELLO.C        "C" source of HELLO program.
  88. FRUIT.C        "C" source of FRUIT program.
  89. POINT.C        "C" source of POINT program.
  90. WASHER.C       "C" source of WASHER program.
  91. SNAKES.C       "C" source of SNAKES program.
  92. SERVER.C       "C" source of SERVER program.
  93. REQUEST.C      "C" source of REQUEST program.
  94. EXAMPLES.C     "C" source of EXAMPLES program.
  95.           
  96. HELLO.PAS      Turbo Pascal source of HELLO program.
  97.  
  98. WASHER_P.C     "C" example utilizing a panel file
  99. WASHER.PAS     Turbo Pascal example utilizing a panel file
  100.  
  101. Installing the example programs:
  102.  
  103. To install and run the examples, put all of the un-ARCed files 
  104. into a directory on your hard drive.  Then run Add a Program from 
  105. the DESQview Open Window menu.  When Add a Program comes up, 
  106. select "Other" from the top of the menu.  Specify the 
  107. drive and subdirectory into which you copied the files.  Add a 
  108. Program should find the EX-PIF.DVP file in the directory and will 
  109. display "Examples" as a selectable program to Add.  Select the 
  110. program, hit the Enter key to add it and keep hitting Enter until 
  111. the item is added to your menu.  Then you may run Examples as you 
  112. would any other installed program.
  113.  
  114.              * * *   E N D   O F   F I L E    * * * 
  115.