Tricks of the Windows Gam…ming Gurus (2nd Edition)/Disc2.iso/msdn_vcb/samples/vc98/mfc/general/docktool/readme.txt

Text File | 1998-03-26 | 8KB | 191 lines

========================================================================
       MICROSOFT FOUNDATION CLASS LIBRARY : DOCKTOOL
========================================================================


This file contains a summary of what you will find in each of the files that
make up the DOCKTOOL demo application.

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

The following files are unchanged from how AppWizard generated them:

DOCKTOOL.MAK
    This project file is compatible with the Visual C++ development
    environment.

    It is also compatible with the NMAKE program provided with Visual C++.

    To build a debug version of the program from the MS-DOS prompt, type


        nmake /f DOCKTOOL.MAK CFG="Win32 Debug"

    or to build a release version of the program, type

        nmake /f DOCKTOOL.MAK CFG="Win32 Release"

DOCKTOOL.H
    This is the main header file for the application.  It includes other
    project specific headers (including RESOURCE.H) and declares the
    CDockApp application class.

DOCKTOOL.CPP
    This is the main application source file that contains the application
    class CDockApp.

RES\DOCKTOOL.ICO
    This is an icon file, which is used as the application's icon.  This
    icon is included by the main resource file DOCKTOOL.RC.

RES\DOCKTOOL.RC2
    This file contains resources that are not edited by the Visual C++
    development environment.  You should place all resources not
    editable by the resource editor in this file.

DOCKTOOL.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.

DOCKDOC.H, DOCKDOC.CPP - the document
    These files contain your CDockDoc class.  Edit these files to
    add your special document data and to implement file saving and loading
    (via CDockDoc::Serialize).

DOCKVW.H, DOCKVW.CPP - the view of the document
    These files contain your CDockView class.
    CDockView objects are used to view CDockDoc objects.

STDAFX.H, STDAFX.CPP
    These files are used to build a precompiled header (PCH) file
    named DOCKTOOL.PCH and a precompiled types file named STDAFX.OBJ.

RESOURCE.H
    This is the standard header file, which defines new resource IDs.
    Visual C++ reads and updates this file.

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

The following files are changed to support the functionality of the demo
application.

MAINFRM.H, MAINFRM.CPP
    These files contain the frame class CMainFrame, which is derived from
    CFrameWnd and controls all SDI frame features.  This file also contains:
    all the toolbar initialization and persistence code; special code for easy
    persistence of the window placement;the code that initializes
    the Tools Dialog and modifies the toolbars if the user presses OK; and
    special code that uses runtime type checking to easily add a right mouse
    button context menu to all toolbars and statusbars.

EDITBAR.H, EDITBAR.CPP
    These files contain the toolbar class CEditBar, which is derived from
    CToolBar and controls the special functionality of the Edit toolbar
    which has a CSearchBox(CComboBox) when it is horizontally oriented and
    a button when it is vertically oriented.  See the comments in these
    source for specifics on how this is accomplished.

SEARCHBX.H, SEARCHBX.CPP
    These files contain the combobox class CSearchBox, which is derived from
    CComboBox and controls the special functionality of the combobox in the
    Edit toolbar.  When the user press enter in the combobox, the text currently
    entered in the combobox is added to the top of the dropdown list.  This is
    done by overloading the PreTranslateMessage method to capture all WM_KEYDOWN
    messages and swallow any VK_RETURN keys and provide alternate functionality.
    It is initially tempting to just add a VK_RETURN accelerator and a command
    handler.  But if this was a real application, you would run into trouble
    quickly because Windows would steal all VK_RETURNs from the application meaning
    that multiline edit controls wouldn't work.  See the comments in these source
    for specifics on how this is accomplished.

PALETTE.H, PALETTE.CPP
    These files contain the toolbar class CPaletteBar, which is derived from
    CToolBar and controls the special functionality of the Palette toolbar
    which has multiple rows or columns.  Originally the idea was to take the
    CPalete class in the CTRLBARS sample and make it dockable.  It turned out
    all that was necessary was to remove a lot of the code in these files,
    and let CToolBar do the work for us.  See the comments in these source
    for specifics on how this is accomplished.

TOOLDLG.H, TOOLDLG.CPP
    These files contain the dialog class CToolDlg, which is derived from
    CDialog.  These files are maintianed completely through Class Wizards.

RES\CBROWSE.BMP
    This bitmap file is used to create tiled images for the Browse toolbar
    when it is in color mode.  Edit this toolbar bitmap along with the
    array in MAINFRM.CPP to add more toolbar buttons.

RES\CDEBUG.BMP
    This bitmap file is used to create tiled images for the Debug toolbar
    when it is in color mode.  Edit this toolbar bitmap along with the
    array in MAINFRM.CPP to add more toolbar buttons.

RES\CEDTHORZ.BMP
    This bitmap file is used to create tiled images for the Edit toolbar
    when it is horizontally oriented and in color mode.  Edit this toolbar
    bitmap along with the array in EDITBAR.CPP to add more toolbar buttons.

RES\CEDTVERT.BMP
    This bitmap file is used to create tiled images for the Edit toolbar
    when it is vertically oriented and in color mode.  Edit this toolbar
    bitmap along with the array in EDITBAR.CPP to add more toolbar buttons.

RES\CMAIN.BMP
    This bitmap file is used to create tiled images for the Main toolbar
    when it is in color mode.  Edit this toolbar bitmap along with the
    array in MAINFRM.CPP to add more toolbar buttons.

RES\CPALETTE.BMP
    This bitmap file is used to create tiled images for the Palette toolbar
    when it is in color mode.  Edit this toolbar bitmap along with the
    array in MAINFRM.CPP to add more toolbar buttons.

RES\CRESRC.BMP
    This bitmap file is used to create tiled images for the Resource toolbar
    when it is in color mode.  Edit this toolbar bitmap along with the
    array in MAINFRM.CPP to add more toolbar buttons.

RES\MBROWSE.BMP
    This bitmap file is used to create tiled images for the Browse toolbar
    when it is in mono mode.  Edit this toolbar bitmap along with the
    array in MAINFRM.CPP to add more toolbar buttons.

RES\MDEBUG.BMP
    This bitmap file is used to create tiled images for the Debug toolbar
    when it is in mono mode.  Edit this toolbar bitmap along with the
    array in MAINFRM.CPP to add more toolbar buttons.

RES\MEDTHORZ.BMP
    This bitmap file is used to create tiled images for the Edit toolbar
    when it is horizontally oriented and in mono mode.  Edit this toolbar
    bitmap along with the array in EDITBAR.CPP to add more toolbar buttons.

RES\MEDTVERT.BMP
    This bitmap file is used to create tiled images for the Edit toolbar
    when it is vertically oriented and in mono mode.  Edit this toolbar
    bitmap along with the array in EDITBAR.CPP to add more toolbar buttons.

RES\MMAIN.BMP
    This bitmap file is used to create tiled images for the Main toolbar
    when it is in mono mode.  Edit this toolbar bitmap along with the
    array in MAINFRM.CPP to add more toolbar buttons.

RES\MPALETTE.BMP
    This bitmap file is used to create tiled images for the Palette toolbar
    when it is in mono mode.  Edit this toolbar bitmap along with the
    array in MAINFRM.CPP to add more toolbar buttons.

RES\MRESRC.BMP
    This bitmap file is used to create tiled images for the Resource toolbar
    when it is in mono mode.  Edit this toolbar bitmap along with the
    array in MAINFRM.CPP to add more toolbar buttons.

DOCKTOOL.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 the
    Visual C++ development environment.