================================================================================ MICROSOFT FOUNDATION CLASS LIBRARY : [!output PROJECT_NAME] Project Overview =============================================================================== The application wizard has created this [!output PROJECT_NAME] application for you. This application not only demonstrates the basics of using the Microsoft Foundation Classes but is also a starting point for writing your application. This file contains a summary of what you will find in each of the files that make up your [!output PROJECT_NAME] application. [!output PROJECT_NAME].vcxproj This is the main project file for VC++ projects generated using an application wizard. It contains information about the version of Visual C++ that generated the file, and information about the platforms, configurations, and project features selected with the application wizard. [!output PROJECT_NAME].vcxproj.filters This is the filters file for VC++ projects generated using an Application Wizard. It contains information about the association between the files in your project and the filters. This association is used in the IDE to show grouping of files with similar extensions under a specific node (for e.g. ".cpp" files are associated with the "Source Files" filter). [!output APP_HEADER] This is the main header file for the application. It includes other project specific headers (including Resource.h) and declares the [!output APP_CLASS] application class. [!output APP_IMPL] This is the main application source file that contains the application class [!output APP_CLASS]. [!output RC_FILE_NAME] This is a listing of all of the Microsoft Windows resources that the program uses. It includes the icons, bitmaps, and cursors that are stored in the RES subdirectory. This file can be directly edited in Microsoft Visual C++. Your project resources are in [!output LCID]. res\[!output PROJECT_NAME].ico This is an icon file, which is used as the application's icon. This icon is included by the main resource file [!output PROJECT_NAME].rc. res\[!output RC2_FILE_NAME].rc2 This file contains resources that are not edited by Microsoft Visual C++. You should place all resources not editable by the resource editor in this file. [!if CONTAINER_SERVER || FULL_SERVER || MINI_SERVER || AUTOMATION || HAS_SUFFIX] [!if !HTML_EDITVIEW] [!output PROJECT_NAME].reg This is an example .reg file that shows you the kind of registration settings the framework will set for you. You can use this as a .reg [!if APP_TYPE_DLG] file to go along with your application. [!else] file to go along with your application or just delete it and rely on the default RegisterShellFileTypes registration. [!endif] [!if AUTOMATION] [!output SAFE_IDL_NAME].idl This file contains the Interface Description Language source code for the type library of your application. [!endif] [!endif] [!endif] [!if !APP_TYPE_DLG] ///////////////////////////////////////////////////////////////////////////// For the main frame window: [!if PROJECT_STYLE_EXPLORER] File Explorer Style: The project will include a File Explorer-like interface, with two frames. [!else] The project includes a standard MFC interface. [!endif] [!output MAIN_FRAME_HEADER], [!output MAIN_FRAME_IMPL] These files contain the frame class [!output MAIN_FRAME_CLASS], which is derived from [!if APP_TYPE_MDI || APP_TYPE_TABBED_MDI] [!if APP_TYPE_MDI] CMDIFrameWnd and controls all MDI frame features. [!else] CMDITabbedFrameWnd and controls all MDI frame features. [!endif] [!else] CFrameWnd and controls all SDI frame features. [!endif] [!if PROJECT_STYLE_EXPLORER] [!output TREE_VIEW_HEADER], [!output TREE_VIEW_IMPL] These files contain the left frame class [!output TREE_VIEW_CLASS], which is derived from CTreeView. [!endif] [!if DOCKING_TOOLBAR || TOOLBAR_STYLE_REBAR || MENUBAR_TOOLBAR || RIBBON_TOOLBAR] res\Toolbar.bmp This bitmap file is used to create tiled images for the toolbar. The initial toolbar and status bar are constructed in the [!output MAIN_FRAME_CLASS] class. Edit this toolbar bitmap using the resource editor, and update the IDR_MAINFRAME TOOLBAR array in [!output PROJECT_NAME].rc to add toolbar buttons. [!if MINI_SERVER || FULL_SERVER || CONTAINER_SERVER] res\IToolbar.bmp This bitmap file is used to create tiled images for the toolbar when your server application is in-place activated inside another container. This toolbar is constructed in the [!output INPLACE_FRAME_CLASS] class. This bitmap is similar to the bitmap in res\Toolbar.bmp except that it has many nonserver commands removed. [!endif] [!endif] [!if APP_TYPE_MDI || APP_TYPE_TABBED_MDI] ///////////////////////////////////////////////////////////////////////////// For the child frame window: ChildFrm.h, ChildFrm.cpp These files define and implement the [!output CHILD_FRAME_CLASS] class, which supports the child windows in an MDI application. [!endif] ///////////////////////////////////////////////////////////////////////////// [!if DOCVIEW] [!if !DB_VIEW_NO_FILE] The application wizard creates one document type and one view: [!output DOC_HEADER], [!output DOC_IMPL] - the document These files contain your [!output DOC_CLASS] class. Edit these files to add your special document data and to implement file saving and loading (via [!output DOC_CLASS]::Serialize). [!if HAS_SUFFIX && !HTML_EDITVIEW] The Document will have the following strings: File extension: [!output FILE_EXTENSION] File type ID: [!output FILE_TYPE_ID] Main frame caption: [!output MAIN_FRAME_CAPTION] Doc type name: [!output DOC_TYPE_NAME] Filter name: [!output FILTER_NAME] File new short name: [!output FILE_NEW_NAME_SHORT] File type long name: [!output FILE_NEW_NAME_LONG] [!endif] [!else] The application wizard creates one view: [!endif] [!output VIEW_HEADER], [!output VIEW_IMPL] - the view of the document These files contain your [!output VIEW_CLASS] class. [!if !DB_VIEW_NO_FILE] [!output VIEW_CLASS] objects are used to view [!output DOC_CLASS] objects. [!endif] [!if APP_TYPE_MDI || APP_TYPE_TABBED_MDI] res\[!output PROJECT_NAME]Doc.ico This is an icon file, which is used as the icon for MDI child windows for the [!output DOC_CLASS] class. This icon is included by the main resource file [!output PROJECT_NAME].rc. [!endif] [!endif] [!if DB_VIEW_NO_FILE || DB_VIEW_WITH_FILE] ///////////////////////////////////////////////////////////////////////////// Database support: [!output ROWSET_HEADER], [!output ROWSET_IMPL] These files contain your [!output ROWSET_CLASS] class. This class is used to access the data source you selected in the wizard. [!if DB_VIEW_NO_FILE] No serialization support will be added. [!else] Serialization support has been added. [!endif] [!endif] [!if CONTAINER || FULL_SERVER || MINI_SERVER || CONTAINER_SERVER] ///////////////////////////////////////////////////////////////////////////// The application wizard has also created classes specific to OLE [!if CONTAINER || CONTAINER_SERVER] [!output CONTAINER_ITEM_HEADER], [!output CONTAINER_ITEM_IMPL] These files contain your [!output CONTAINER_ITEM_CLASS] class. This class is used to manipulate OLE objects. OLE objects are usually displayed by your [!output VIEW_CLASS] class and serialized as part of your [!output DOC_CLASS] class. [!if ACTIVE_DOC_CONTAINER] The program includes support to contain Active documents within its frame. [!endif] [!endif] [!if MINI_SERVER || FULL_SERVER || CONTAINER_SERVER] [!output SERVER_ITEM_HEADER], [!output SERVER_ITEM_IMPL] These files contain your [!output SERVER_ITEM_CLASS]. This class is used to connect your [!output DOC_CLASS] class to the OLE system, and optionally provide links to your document. [!if ACTIVE_DOC_SERVER] The project has support to create and manage Active documents. [!endif] [!output INPLACE_FRAME_HEADER], [!output INPLACE_FRAME_IMPL] These files contain your [!output INPLACE_FRAME_CLASS]. This class is derived from COleIPFrameWnd and controls all frame features during in-place activation. [!endif] [!if SUPPORT_COMPOUND_FILES] The project has support for Compound files. The Compound-file format stores a document that contains one or more Automation objects to one file and still allows access to the it for the individual objects. [!endif] [!endif] [!else] ///////////////////////////////////////////////////////////////////////////// [!if AUTOMATION] The application wizard creates one dialog class and automation proxy class: [!else] The application wizard creates one dialog class: [!endif] [!output DIALOG_HEADER], [!output DIALOG_IMPL] - the dialog These files contain your [!output DIALOG_CLASS] class. This class defines the behavior of your application's main dialog. The dialog's template is in [!output PROJECT_NAME].rc, which can be edited in Microsoft Visual C++. [!if AUTOMATION] [!output DIALOG_AUTO_PROXY_HEADER], [!output DIALOG_AUTO_PROXY_IMPL] - the automation object These files contain your [!output DIALOG_AUTO_PROXY_CLASS] class. This class is called the Automation proxy class for your dialog, because it takes care of exposing the Automation methods and properties that Automation controllers can use to access your dialog. These methods and properties are not exposed from the dialog class directly, because in the case of a modal dialog-based MFC application it is cleaner and easier to keep the Automation object separate from the user interface. [!endif] [!endif] [!if ACTIVEX_CONTROLS || PRINTING || SPLITTER || MAPI || SOCKETS] ///////////////////////////////////////////////////////////////////////////// Other Features: [!if ACTIVEX_CONTROLS] ActiveX Controls The application includes support to use ActiveX controls. [!endif] [!if PRINTING] Printing and Print Preview support The application wizard has generated code to handle the print, print setup, and print preview commands by calling member functions in the CView class from the MFC library. [!endif] [!if DB_SUPPORT_HEADER_ONLY && !APP_TYPE_DLG] Database support The application wizard has added the basic level of database support for your program. Only the needed files have been included. [!endif] [!if SPLITTER && !APP_TYPE_DLG] Split Window The application wizard has added support for splitter windows for your application documents. [!endif] [!if MAPI] MAPI support The generated project contains the code needed to create, manipulate, transfer and store mail messages. [!endif] [!if SOCKETS] Windows Sockets The application has support for establishing communications over TCP/IP networks. [!endif] [!endif] ///////////////////////////////////////////////////////////////////////////// Other standard files: StdAfx.h, StdAfx.cpp These files are used to build a precompiled header (PCH) file named [!output PROJECT_NAME].pch and a precompiled types file named StdAfx.obj. Resource.h This is the standard header file, which defines new resource IDs. Microsoft Visual C++ reads and updates this file. [!if MANIFEST] [!output PROJECT_NAME].manifest Application manifest files are used by Windows XP to describe an applications dependency on specific versions of Side-by-Side assemblies. The loader uses this information to load the appropriate assembly from the assembly cache or private from the application. The Application manifest maybe included for redistribution as an external .manifest file that is installed in the same folder as the application executable or it may be included in the executable in the form of a resource. [!endif] ///////////////////////////////////////////////////////////////////////////// Other notes: The application wizard uses "TODO:" to indicate parts of the source code you should add to or customize. [!if APP_TYPE_MDI || APP_TYPE_TABBED_MDI || APP_TYPE_SDI || APP_TYPE_DLG || APP_TYPE_MTLD] If your application uses MFC in a shared DLL, you will need to redistribute the MFC DLLs. If your application is in a language other than the operating system's locale, you will also have to redistribute the corresponding localized resources mfc110XXX.DLL. For more information on both of these topics, please see the section on redistributing Visual C++ applications in MSDN documentation. [!endif] /////////////////////////////////////////////////////////////////////////////