WinBegin

	WinBegin is a development tool for creating very simple "C" 
programs which run under Windows.  WinBegin is meant to be used by
the "C" programmer who wants to create his or her first Windows program.
The more experienced Window developer may find it useful for making
skeleton programs for new applications.

	WinBegin actually generates "C" and Windows code for a small
application.  When the user chooses the "Make Program" menu option,
WinBegin prompts for a program name, a directory name, a program 
description, and the author's name.  When all these items have been
entered, WinBegin creates the source code for a Windows application.
The files created include:

name.c
name.h
name.def
name.rc
name.ico
name

where "name" is the program name selected by the author. The "name.c"
file contains the application's "C" source code.  "name.h" contains
constant definitions.  "name.def" contains information needed by Windows
at link time.  "name" contains a makefile for compiling the application.
"name.ico" contains a dummy (blank) icon for the application.  You can,
and should, make a meaningful icon for your application using the icon
editor, "iconedit.exe". 

	After running WinBegin, the programmer should exit Windows and 
change to the directory that was chosen to contain the generated files.
Then the programmer need only type "make name" to make a Windows 
executable file.

	What does this executable file do?  It contains two menu items:
File, and GetText.  File has two choices:  Exit, and About this application.  
The About choice displays an About dialog box with the name of the program
and the author's name.  GetText displays a dialog box which prompts for
a line of text.  When the box is exited, the text is displayed on the
screen.  The executable file also can display an About box which contains
a description of the program and a copyright notice with the author's
name.  

	Thus WinBegin creates source code for an application that has
menu-bar commands, and which uses two dialog boxes.  This is what I 
consider to be the smallest non-trivial Windows program.  The generated
files are meant to be modified!  Here are some things to try:

-  Add another menu item.  Adding, deleting, and changing the names of
   menu items are just about the easiest things to do in Windows.

-  Add another dialog box.  Remember that the names of the dialog box
   functions must be added to the EXPORTS section of the name.def file,
   in order to prevent nasty things from happening.

-  Experiment with some of the more sophisticated dialog box controls,
   such as list boxes and edit boxes.

-  Instead of printing text using TextOut, try out some of the drawing
   functions, such as Rectangle and LineTo.

Files included in the archive are:

readme.txt
winbeg1.exe
winbeg2.exe
winbegin.dat
winbegin.ico
target.ico

	If you are running Windows Version 1, use winbeg1.exe.  If you are
running Windows Version 2, use winbeg2.exe.  I have tested programs generated
by winbeg2 and compiled with the version 2 SDK and run under Windows version 2.
I have also tested programs generated by winbeg1 and compiled with the 
version 2 SDK and run under Windows version 1.  I have not tested the 
compilation of programs generated by winbeg1 using the version 1 SDK.


Copyright 1987 by Susan Crayne.  All Rights Reserved
Written for uploading to Compuserve Forums by

	Susan Crayne
	50 Butler Street
	Brooklyn, New York 112321

This program may be distributed freely.  The copyright holder offers no
warranty with this code whatsoever, including its fitness for any particular
purpose.  Neither shall she be liable for damages of any kind that may arise
from its use.