home *** CD-ROM | disk | FTP | other *** search
/ Shareware Overload / ShartewareOverload.cdr / windows / winbeg.zip / README.TXT next >
Text File  |  1987-12-06  |  4KB  |  91 lines
  1.                 WinBegin
  2.  
  3.     WinBegin is a development tool for creating very simple "C" 
  4. programs which run under Windows.  WinBegin is meant to be used by
  5. the "C" programmer who wants to create his or her first Windows program.
  6. The more experienced Window developer may find it useful for making
  7. skeleton programs for new applications.
  8.  
  9.     WinBegin actually generates "C" and Windows code for a small
  10. application.  When the user chooses the "Make Program" menu option,
  11. WinBegin prompts for a program name, a directory name, a program 
  12. description, and the author's name.  When all these items have been
  13. entered, WinBegin creates the source code for a Windows application.
  14. The files created include:
  15.  
  16. name.c
  17. name.h
  18. name.def
  19. name.rc
  20. name.ico
  21. name
  22.  
  23. where "name" is the program name selected by the author. The "name.c"
  24. file contains the application's "C" source code.  "name.h" contains
  25. constant definitions.  "name.def" contains information needed by Windows
  26. at link time.  "name" contains a makefile for compiling the application.
  27. "name.ico" contains a dummy (blank) icon for the application.  You can,
  28. and should, make a meaningful icon for your application using the icon
  29. editor, "iconedit.exe". 
  30.  
  31.     After running WinBegin, the programmer should exit Windows and 
  32. change to the directory that was chosen to contain the generated files.
  33. Then the programmer need only type "make name" to make a Windows 
  34. executable file.
  35.  
  36.     What does this executable file do?  It contains two menu items:
  37. File, and GetText.  File has two choices:  Exit, and About this application.  
  38. The About choice displays an About dialog box with the name of the program
  39. and the author's name.  GetText displays a dialog box which prompts for
  40. a line of text.  When the box is exited, the text is displayed on the
  41. screen.  The executable file also can display an About box which contains
  42. a description of the program and a copyright notice with the author's
  43. name.  
  44.  
  45.     Thus WinBegin creates source code for an application that has
  46. menu-bar commands, and which uses two dialog boxes.  This is what I 
  47. consider to be the smallest non-trivial Windows program.  The generated
  48. files are meant to be modified!  Here are some things to try:
  49.  
  50. -  Add another menu item.  Adding, deleting, and changing the names of
  51.    menu items are just about the easiest things to do in Windows.
  52.  
  53. -  Add another dialog box.  Remember that the names of the dialog box
  54.    functions must be added to the EXPORTS section of the name.def file,
  55.    in order to prevent nasty things from happening.
  56.  
  57. -  Experiment with some of the more sophisticated dialog box controls,
  58.    such as list boxes and edit boxes.
  59.  
  60. -  Instead of printing text using TextOut, try out some of the drawing
  61.    functions, such as Rectangle and LineTo.
  62.  
  63. Files included in the archive are:
  64.  
  65. readme.txt
  66. winbeg1.exe
  67. winbeg2.exe
  68. winbegin.dat
  69. winbegin.ico
  70. target.ico
  71.  
  72.     If you are running Windows Version 1, use winbeg1.exe.  If you are
  73. running Windows Version 2, use winbeg2.exe.  I have tested programs generated
  74. by winbeg2 and compiled with the version 2 SDK and run under Windows version 2.
  75. I have also tested programs generated by winbeg1 and compiled with the 
  76. version 2 SDK and run under Windows version 1.  I have not tested the 
  77. compilation of programs generated by winbeg1 using the version 1 SDK.
  78.  
  79.  
  80. Copyright 1987 by Susan Crayne.  All Rights Reserved
  81. Written for uploading to Compuserve Forums by
  82.  
  83.     Susan Crayne
  84.     50 Butler Street
  85.     Brooklyn, New York 112321
  86.  
  87. This program may be distributed freely.  The copyright holder offers no
  88. warranty with this code whatsoever, including its fitness for any particular
  89. purpose.  Neither shall she be liable for damages of any kind that may arise
  90. from its use.
  91.