Return to readme.txt CVS log

Up to [WindowsNT SDKs] / mstools / mfc / samples / hello

Annotation of mstools/mfc/samples/hello/readme.txt, revision 1.1.1.1

1.1       root        1: ========================================================================
                      2:           MICROSOFT FOUNDATION CLASS LIBRARY : HELLO EXAMPLE PROGRAM
                      3: ========================================================================
                      4: 
                      5: This application is a simple Windows program to demonstrate the basics
                      6: of using the Microsoft Foundation classes.  The Microsoft Foundation
                      7: Class Library Tutorial describes this application in detail, but here's
                      8: a summary of what you will find in each of the files that make up Hello.
                      9: 
                     10: MAKEFILE.
                     11: HELLO.MAK
                     12: HELLO.STS
                     13:        These two files make it easy to compile the application.  The
                     14:        MAKEFILE describes the build process for the NMAKE tool, and the
                     15:        other files, HELLO.MAK and HELLO.STS, make it easy to use the
                     16:        Programmer's Workbench to build HELLO.
                     17: 
                     18:        To use the MAKEFILE, just go to the DOS prompt, and type
                     19:                nmake
                     20:        to build the program.  You can choose to include
                     21:        debugging support by using the option:
                     22:                nmake DEBUG=1
                     23:        (Make sure you use uppercase letters for this option.) 
                     24:        The DEBUG=0 option specifies that no support is compiled into the
                     25:        code.  If you do not specify a DEBUG option, the default is 
                     26:        DEBUG=0.
                     27: 
                     28: 
                     29: HELLO.H
                     30: HELLO.CPP
                     31:        These two files make up the entire behavior of the application.
                     32:        In the HELLO.H header file, two C++ classes are declared: CTheApp
                     33:        and CMainWindow.  These classes override and extend the behavior
                     34:        of their base Foundation classes, CWinApp and CFrameWnd,
                     35:        respectively.  The source file HELLO.CPP contains the member functions
                     36:        and message maps declared in the header file.
                     37: 
                     38:        CWinApp, a Foundation class, does all of the typical stuff that
                     39:        most Microsoft Windows applications must:  it initializes itself,
                     40:        then it creates and runs a message loop until the application ends.
                     41:        The Hello program extends this behavior by overriding the
                     42:        InitInstance member function in our own class, CTheApp.  This
                     43:        member function is automatically called during startup of the
                     44:        application.  In InitInstance, we create and show our main window.
                     45: 
                     46:        CMainWindow is a pretty simple window class, and it follows the
                     47:        typical behavior found in frame windows.  It is based on CFrameWnd,
                     48:        a Foundation class.  Our frame window uses a message map to
                     49:        associate member functions with Microsoft Windows messages.  These
                     50:        functions respond to the standard paint message, and a menu choice
                     51:        command message.
                     52: 
                     53:        Since the Foundation provides all of the normal code for the
                     54:        WinMain function and other initialization (in the CWinApp class),
                     55:        it is only necessary to create an object of our CTheApp class to
                     56:        start the program and let it run.  This is found in the one global
                     57:        variable in HELLO.CPP, called theApp.
                     58: 
                     59: HELLO.ICO
                     60:        This is an icon file, which is used by the Hello frame window.
                     61: 
                     62: HELLO.DLG
                     63:        This is a dialog definition file, which defines the
                     64:        characteristics and layout of the modal dialog AboutBox,
                     65:        which is displayed by the Hello application.  This dialog file
                     66:        was generated using the Windows 3.1 SDK DLGEDIT tool.
                     67: 
                     68: 
                     69: RESOURCE.H
                     70:        This is a header file that contains Windows menu item IDs.
                     71:        It was generated using the Windows 3.1 SDK DLGEDIT tool.
                     72: 
                     73: HELLO.RC
                     74:        This is a listing of all of the Microsoft Windows resources which
                     75:        the program uses.  It includes three resources: the icon found in
                     76:        HELLO.ICO, a menu, and the dialog defined in HELLO.DLG.
                     77: 
                     78: HELLO.DEF
                     79:        This file contains parameters the linker needs to correctly
                     80:        link a Microsoft Windows application, including: the name and
                     81:        description of the application, and the size and type of the runtime
                     82:        heap and runtime stack.  The numbers in this file are typical for
                     83:        small applications made with the Microsoft Foundation Class Library.

This archive runs on limited infrastructure. Preserving old code on modern bandwidth. Automated agents are requested to crawl responsibly.