home
***
CD-ROM
|
disk
|
FTP
|
other
***
search
/
Tricks of the Windows Gam…ming Gurus (2nd Edition)
/
Disc2.iso
/
msdn_vcb
/
samples
/
vc98
/
appwiz
/
logowiz
/
template
/
readme.txt
< prev
next >
Wrap
Text File
|
1998-03-05
|
13KB
|
337 lines
========================================================================
MICROSOFT FOUNDATION CLASS LIBRARY : $$Root$$
========================================================================
$$IF(PROJTYPE_DLL)
Custom AppWizard "My Logo AppWizard" has created this $$ROOT$$ DLL for
you. This DLL not only demonstrates the basics of using the Microsoft
Foundation classes but is also a starting point for writing your DLL.
This file contains a summary of what you will find in each of the files that
make up your $$Root$$ DLL.
$$ELSE
Custom AppWizard "My Logo AppWizard" has created this $$ROOT$$ 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.
$$IF(LOGO_YES || PRESS_ME_DIALOG)
Custom AppWizard "My Logo AppWizard" added the following extra functionality
for you:
$$IF(LOGO_YES)
$$IF(LOGO_UPLEFT)
- the IDR_MAINFRAME icon was placed in the upper left corner of your
$$ELIF(LOGO_LOLEFT)
- the IDR_MAINFRAME icon was placed in the lower left corner of your
$$ELSE //(LOGO_LORIGHT)
- the IDR_MAINFRAME icon was placed in the lower right corner of your
$$ENDIF
dialog-based app
$$ENDIF //LOGO_YES
$$IF(PRESS_ME_DIALOG)
- a button labeled 'Press me' was placed near the center of your dialog-
based app. Pressing this button will bring up a dialog that contains
two owner-draw bitmap buttons
$$ENDIF
$$ENDIF //LOGO_YES || PRESS_ME_DIALOG
This file contains a summary of what you will find in each of the files that
make up your $$Root$$ application.
$$ENDIF //PROJTYPE_DLL
$$Root$$.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.
$$IF(PROJTYPE_DLL)
$$IF(EXTDLL)
$$Root$$.cpp
This is the main DLL source file that contains the definition of
DllMain().
$$ELSE //!EXTDLL
$$Root$$.h
This is the main header file for the DLL. It declares the
$$APP_CLASS$$ class.
$$Root$$.cpp
This is the main DLL source file. It contains the class $$APP_CLASS$$.
$$IF(AUTOMATION)
It also contains the OLE entry points required of inproc servers.
$$ENDIF //AUTOMATION
$$ENDIF //EXTDLL
$$IF(AUTOMATION)
$$Root$$.odl
This file contains the Object Description Language source code for the
type library of your DLL.
$$ENDIF //AUTOMATION
$$ELSE //!PROJTYPE_DLL
$$Root$$.h
This is the main header file for the application. It includes other
project specific headers (including Resource.h) and declares the
$$APP_CLASS$$ application class.
$$Root$$.cpp
This is the main application source file that contains the application
class $$APP_CLASS$$.
$$ENDIF //PROJTYPE_DLL
$$Root$$.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++.
$$Root$$.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.
$$IF(!PROJTYPE_DLL)
res\$$Root$$.ico
This is an icon file, which is used as the application's icon. This
icon is included by the main resource file $$Root$$.rc.
$$ENDIF //!PROJTYPE_DLL
res\$$Root$$.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(!PROJTYPE_DLL)
$$IF(CONTAINER_SERVER || FULL_SERVER || MINI_SERVER || AUTOMATION || HAS_SUFFIX)
$$Root$$.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(PROJTYPE_DLG)
file to go along with your application.
$$ELSE //!DLG
file to go along with your application or just delete it and rely
on the default RegisterShellFileTypes registration.
$$ENDIF //PROJTYPE_DLG
$$ENDIF //OLE || HAS_SUFFIX
$$IF(AUTOMATION)
$$Root$$.odl
This file contains the Object Description Language source code for the
type library of your application.
$$ENDIF //AUTOMATION
$$ENDIF //!PROJTYPE_DLL
$$IF(PROJTYPE_DLL)
$$Root$$.def
This file contains information about the DLL that must be
provided to run with Microsoft Windows. It defines parameters
such as the name and description of the DLL. It also exports
functions from the DLL.
$$ENDIF //PROJTYPE_DLL
$$IF(!PROJTYPE_DLL)
$$IF(!PROJTYPE_DLG)
/////////////////////////////////////////////////////////////////////////////
For the main frame window:
$$FRAME_HFILE$$.h, $$FRAME_IFILE$$.cpp
These files contain the frame class $$FRAME_CLASS$$, which is derived from
$$IF(PROJTYPE_MDI)
CMDIFrameWnd and controls all MDI frame features.
$$ELSE
CFrameWnd and controls all SDI frame features.
$$ENDIF
$$IF(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 $$FRAME_CLASS$$
class. Edit this toolbar bitmap using the resource editor, and
update the IDR_MAINFRAME TOOLBAR array in $$Root$$.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 $$IPFRAME_CLASS$$
class. This bitmap is similar to the bitmap in res\Toolbar.bmp
except that it has many non-server commands removed.
$$ENDIF //SERVER
$$ENDIF //TOOLBAR
$$IF(LOGO_YES)
RES\LOGO.BMP
This bitmap file is used to display your company logo on the dialog
window.
$$ENDIF //LOGO
$$IF(PROJTYPE_MDI) //If an MDI app, it will contain a ChildFrm class
/////////////////////////////////////////////////////////////////////////////
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.
$$ENDIF //PROJTYPE_MDI
/////////////////////////////////////////////////////////////////////////////
$$IF(!NODOCVIEW)
$$IF(!DB_NO_FILE)
AppWizard creates one document type and one view:
$$DOC_HFILE$$.h, $$DOC_IFILE$$.cpp - the document
These files contain your $$DOC_CLASS$$ class. Edit these files to
add your special document data and to implement file saving and loading
(via $$DOC_CLASS$$::Serialize).
$$ELSE
AppWizard creates one view:
$$ENDIF
$$VIEW_HFILE$$.h, $$VIEW_IFILE$$.cpp - the view of the document
These files contain your $$VIEW_CLASS$$ class.
$$IF(!DB_NO_FILE)
$$VIEW_CLASS$$ objects are used to view $$DOC_CLASS$$ objects.
$$ENDIF
$$IF(CRecordView)
//For an ODBC database app:
$$RECSET_HFILE$$.h, $$RECSET_IFILE$$.cpp - the recordset
These files define and implement the recordset class $$RECSET_CLASS$$,
which performs database query and collection.
$$ENDIF
$$IF(CDaoRecordView)
//For a DAO database app:
$$RECSET_HFILE$$.h, $$RECSET_IFILE$$.cpp - the recordset
These files define and implement the recordset class $$RECSET_CLASS$$,
which performs database query and collection.
$$ENDIF
$$IF(PROJTYPE_MDI)
res\$$DOC_IFILE$$.ico
This is an icon file, which is used as the icon for MDI child windows
for the $$DOC_CLASS$$ class. This icon is included by the main
resource file $$Root$$.rc.
$$ENDIF //MDI
$$ENDIF
$$IF(CONTAINER || FULL_SERVER || MINI_SERVER || CONTAINER_SERVER)
/////////////////////////////////////////////////////////////////////////////
AppWizard has also created classes specific to OLE
$$IF(CONTAINER || CONTAINER_SERVER)
$$CNTRITEM_HFILE$$.h, $$CNTRITEM_IFILE$$.cpp - this class is used to
manipulate OLE objects. OLE objects are usually displayed by your
$$VIEW_CLASS$$ class and serialized as part of your $$DOC_CLASS$$ class.
$$ENDIF
$$IF(MINI_SERVER || FULL_SERVER || CONTAINER_SERVER)
$$SRVRITEM_HFILE$$.h, $$SRVRITEM_IFILE$$.cpp - this class is used to
connect your $$DOC_CLASS$$ class to the OLE system, and optionally
provide links to your document.
$$IPFRAME_HFILE$$.h, $$IPFRAME_IFILE$$.cpp - this class is derived
from COleIPFrameWnd and controls all frame features during
in-place activation.
$$ENDIF
$$ENDIF
$$ELSE //!!PROJTYPE_DLG
/////////////////////////////////////////////////////////////////////////////
$$IF(AUTOMATION)
AppWizard creates one dialog class and automation proxy class:
$$ELSE //!AUTOMATION
AppWizard creates one dialog class:
$$ENDIF //AUTOMATION
$$DLG_HFILE$$.h, $$DLG_IFILE$$.cpp - the dialog
These files contain your $$DLG_CLASS$$ class. This class defines
the behavior of your application's main dialog. The dialog's
template is in $$Root$$.rc, which can be edited in Microsoft
Visual C++.
$$IF(AUTOMATION)
$$DLGAUTOPROXY_HFILE$$.h, $$DLGAUTOPROXY_IFILE$$.cpp - the automation object
These files contain your $$DLGAUTOPROXY_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 //AUTOMATION
$$IF(PRESS_ME_DIALOG)
Custom AppWizard "My Logo AppWizard" copies over extra materials to handle
the "Press Me" dialog:
PRESSDLG.H, PRESSDLG.CPP - the "Press Me" dialog
These files contain class CPressMeDlg. This class implements the
"Press Me" dialog which is reached by pressing the "Press me" button
on your application's main dialog. The dialog's template is in
$$ROOT$$.RC, which can be edited in Microsoft Visual C++.
RES\SMILEU.BMP, RES\SMILED.BMP, RES\SMILEF.BMP
RES\FROWNU.BMP, RES\FROWND.BMP, RES\FROWNF.BMP
These bitmaps are used to draw the owner-draw buttons on the "Press Me"
dialog. The first set of buttons is for the OK button. The second set
is for the Cancel button. For each set of buttons, the first one is
displayed when the button is in the 'up' position, the second one is
displayed when the button is in the 'down' position, and the last one is
displayed when the button has the focus.
$$ENDIF //PRESS_ME_DIALOG
$$ENDIF //!PROJTYPE_DLG
$$IF(HELP)
/////////////////////////////////////////////////////////////////////////////
Help Support:
hlp\$$Root$$.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.
$$ENDIF //HELP
$$ENDIF //!PROJTYPE_DLL
/////////////////////////////////////////////////////////////////////////////
Other standard files:
StdAfx.h, StdAfx.cpp
These files are used to build a precompiled header (PCH) file
named $$Root$$.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(PROJTYPE_MDI || PROJTYPE_SDI || PROJTYPE_DLG)
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.
$$ENDIF //MDI,SDI,DLG
/////////////////////////////////////////////////////////////////////////////