usgs-coupled / phreeqci

1 stars 1 forks source link

======================================================================== MICROSOFT FOUNDATION CLASS LIBRARY : phreeqci2

AppWizard has created this phreeqci2 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 phreeqci2 application.

phreeqci2.dsp This file (the project file) contains information at the project level and is used to build a single project or subproject. Other users can share the project (.dsp) file, but they should export the makefiles locally.

phreeqci2.h This is the main header file for the application. It includes other project specific headers (including Resource.h) and declares the CPhreeqciApp application class.

phreeqci2.cpp This is the main application source file that contains the application class CPhreeqciApp.

phreeqci2.rc 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++.

phreeqci2.clw This file contains information used by ClassWizard to edit existing classes or add new classes. ClassWizard also uses this file to store information needed to create and edit message maps and dialog data maps and to create prototype member functions.

res\phreeqci2.ico This is an icon file, which is used as the application's icon. This icon is included by the main resource file phreeqci2.rc.

res\phreeqci2.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.

phreeqci2.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 file to go along with your application or just delete it and rely on the default RegisterShellFileTypes registration.

/////////////////////////////////////////////////////////////////////////////

For the main frame window:

MainFrame.h, MainFrame.cpp These files contain the frame class CMainFrame, which is derived from CMDIFrameWnd and controls all MDI frame features.

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 CMainFrame class. Edit this toolbar bitmap using the resource editor, and update the IDR_MAINFRAME TOOLBAR array in phreeqci2.rc to add toolbar buttons. /////////////////////////////////////////////////////////////////////////////

For the child frame window:

ChildFrm.h, ChildFrm.cpp These files define and implement the CChildFrame class, which supports the child windows in an MDI application.

/////////////////////////////////////////////////////////////////////////////

AppWizard creates one document type and one view:

RichDocIn.h, RichDocIn.cpp - the document These files contain your CRichDocIn class. Edit these files to add your special document data and to implement file saving and loading (via CRichDocIn::Serialize).

RichViewIn.h, RichViewIn.cpp - the view of the document These files contain your CRichViewIn class. CRichViewIn objects are used to view CRichDocIn objects.

res\RichDocIn.ico This is an icon file, which is used as the icon for MDI child windows for the CRichDocIn class. This icon is included by the main resource file phreeqci2.rc.

/////////////////////////////////////////////////////////////////////////////

AppWizard has also created classes specific to OLE

RichInCntrItem.h, RichInCntrItem.cpp - this class is used to manipulate OLE objects. OLE objects are usually displayed by your CRichViewIn class and serialized as part of your CRichDocIn class.

/////////////////////////////////////////////////////////////////////////////

Help Support:

hlp\phreeqci2.hpj This file is the Help Project file used by the Help compiler to create your application's Help file.

hlp*.bmp These are bitmap files required by the standard Help file topics for Microsoft Foundation Class Library standard commands.

hlp*.rtf This file contains the standard help topics for standard MFC commands and screen objects.

///////////////////////////////////////////////////////////////////////////// Other standard files:

StdAfx.h, StdAfx.cpp These files are used to build a precompiled header (PCH) file named phreeqci2.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.

///////////////////////////////////////////////////////////////////////////// Other notes:

AppWizard uses "TODO:" to indicate parts of the source code you should add to or customize.

If your application uses MFC in a shared DLL, and your application is in a language other than the operating system's current language, you will need to copy the corresponding localized resources MFC42XXX.DLL from the Microsoft Visual C++ CD-ROM onto the system or system32 directory, and rename it to be MFCLOC.DLL. ("XXX" stands for the language abbreviation. For example, MFC42DEU.DLL contains resources translated to German.) If you don't do this, some of the UI elements of your application will remain in the language of the operating system.

/////////////////////////////////////////////////////////////////////////////