home *** CD-ROM | disk | FTP | other *** search
/ QBasic & Borland Pascal & C / Delphi5.iso / Basic / Visual Basic.60 / COMMON / TOOLS / VCM / VCM.MDB / VcmComponentContainer / 13_Cabinet / README.TXT < prev    next >
Encoding:
Text File  |  1998-05-18  |  8.1 KB  |  191 lines
  1. ========================================================================
  2.        MICROSOFT FOUNDATION CLASS LIBRARY : DOCKTOOL
  3. ========================================================================
  4.  
  5.  
  6. This file contains a summary of what you will find in each of the files that
  7. make up the DOCKTOOL demo application.
  8.  
  9. /////////////////////////////////////////////////////////////////////////////
  10.  
  11. The following files are unchanged from how AppWizard generated them:
  12.  
  13. DOCKTOOL.MAK
  14.     This project file is compatible with the Visual C++ development
  15.     environment.
  16.  
  17.     It is also compatible with the NMAKE program provided with Visual C++.
  18.  
  19.     To build a debug version of the program from the MS-DOS prompt, type
  20.  
  21.  
  22.         nmake /f DOCKTOOL.MAK CFG="Win32 Debug"
  23.  
  24.     or to build a release version of the program, type
  25.  
  26.         nmake /f DOCKTOOL.MAK CFG="Win32 Release"
  27.  
  28. DOCKTOOL.H
  29.     This is the main header file for the application.  It includes other
  30.     project specific headers (including RESOURCE.H) and declares the
  31.     CDockApp application class.
  32.  
  33. DOCKTOOL.CPP
  34.     This is the main application source file that contains the application
  35.     class CDockApp.
  36.  
  37. RES\DOCKTOOL.ICO
  38.     This is an icon file, which is used as the application's icon.  This
  39.     icon is included by the main resource file DOCKTOOL.RC.
  40.  
  41. RES\DOCKTOOL.RC2
  42.     This file contains resources that are not edited by the Visual C++
  43.     development environment.  You should place all resources not
  44.     editable by the resource editor in this file.
  45.  
  46. DOCKTOOL.CLW
  47.     This file contains information used by ClassWizard to edit existing
  48.     classes or add new classes.  ClassWizard also uses this file to store
  49.     information needed to create and edit message maps and dialog data
  50.     maps and to create prototype member functions.
  51.  
  52. DOCKDOC.H, DOCKDOC.CPP - the document
  53.     These files contain your CDockDoc class.  Edit these files to
  54.     add your special document data and to implement file saving and loading
  55.     (via CDockDoc::Serialize).
  56.  
  57. DOCKVW.H, DOCKVW.CPP - the view of the document
  58.     These files contain your CDockView class.
  59.     CDockView objects are used to view CDockDoc objects.
  60.  
  61. STDAFX.H, STDAFX.CPP
  62.     These files are used to build a precompiled header (PCH) file
  63.     named DOCKTOOL.PCH and a precompiled types file named STDAFX.OBJ.
  64.  
  65. RESOURCE.H
  66.     This is the standard header file, which defines new resource IDs.
  67.     Visual C++ reads and updates this file.
  68.  
  69. /////////////////////////////////////////////////////////////////////////////
  70.  
  71. The following files are changed to support the functionality of the demo
  72. application.
  73.  
  74. MAINFRM.H, MAINFRM.CPP
  75.     These files contain the frame class CMainFrame, which is derived from
  76.     CFrameWnd and controls all SDI frame features.  This file also contains:
  77.     all the toolbar initialization and persistence code; special code for easy
  78.     persistence of the window placement;the code that initializes
  79.     the Tools Dialog and modifies the toolbars if the user presses OK; and
  80.     special code that uses runtime type checking to easily add a right mouse
  81.     button context menu to all toolbars and statusbars.
  82.  
  83. EDITBAR.H, EDITBAR.CPP
  84.     These files contain the toolbar class CEditBar, which is derived from
  85.     CToolBar and controls the special functionality of the Edit toolbar
  86.     which has a CSearchBox(CComboBox) when it is horizontally oriented and
  87.     a button when it is vertically oriented.  See the comments in these
  88.     source for specifics on how this is accomplished.
  89.  
  90. SEARCHBX.H, SEARCHBX.CPP
  91.     These files contain the combobox class CSearchBox, which is derived from
  92.     CComboBox and controls the special functionality of the combobox in the
  93.     Edit toolbar.  When the user press enter in the combobox, the text currently
  94.     entered in the combobox is added to the top of the dropdown list.  This is
  95.     done by overloading the PreTranslateMessage method to capture all WM_KEYDOWN
  96.     messages and swallow any VK_RETURN keys and provide alternate functionality.
  97.     It is initially tempting to just add a VK_RETURN accelerator and a command
  98.     handler.  But if this was a real application, you would run into trouble
  99.     quickly because Windows would steal all VK_RETURNs from the application meaning
  100.     that multiline edit controls wouldn't work.  See the comments in these source
  101.     for specifics on how this is accomplished.
  102.  
  103. PALETTE.H, PALETTE.CPP
  104.     These files contain the toolbar class CPaletteBar, which is derived from
  105.     CToolBar and controls the special functionality of the Palette toolbar
  106.     which has multiple rows or columns.  Originally the idea was to take the
  107.     CPalete class in the CTRLBARS sample and make it dockable.  It turned out
  108.     all that was necessary was to remove a lot of the code in these files,
  109.     and let CToolBar do the work for us.  See the comments in these source
  110.     for specifics on how this is accomplished.
  111.  
  112. TOOLDLG.H, TOOLDLG.CPP
  113.     These files contain the dialog class CToolDlg, which is derived from
  114.     CDialog.  These files are maintianed completely through Class Wizards.
  115.  
  116. RES\CBROWSE.BMP
  117.     This bitmap file is used to create tiled images for the Browse toolbar
  118.     when it is in color mode.  Edit this toolbar bitmap along with the
  119.     array in MAINFRM.CPP to add more toolbar buttons.
  120.  
  121. RES\CDEBUG.BMP
  122.     This bitmap file is used to create tiled images for the Debug toolbar
  123.     when it is in color mode.  Edit this toolbar bitmap along with the
  124.     array in MAINFRM.CPP to add more toolbar buttons.
  125.  
  126. RES\CEDTHORZ.BMP
  127.     This bitmap file is used to create tiled images for the Edit toolbar
  128.     when it is horizontally oriented and in color mode.  Edit this toolbar
  129.     bitmap along with the array in EDITBAR.CPP to add more toolbar buttons.
  130.  
  131. RES\CEDTVERT.BMP
  132.     This bitmap file is used to create tiled images for the Edit toolbar
  133.     when it is vertically oriented and in color mode.  Edit this toolbar
  134.     bitmap along with the array in EDITBAR.CPP to add more toolbar buttons.
  135.  
  136. RES\CMAIN.BMP
  137.     This bitmap file is used to create tiled images for the Main toolbar
  138.     when it is in color mode.  Edit this toolbar bitmap along with the
  139.     array in MAINFRM.CPP to add more toolbar buttons.
  140.  
  141. RES\CPALETTE.BMP
  142.     This bitmap file is used to create tiled images for the Palette toolbar
  143.     when it is in color mode.  Edit this toolbar bitmap along with the
  144.     array in MAINFRM.CPP to add more toolbar buttons.
  145.  
  146. RES\CRESRC.BMP
  147.     This bitmap file is used to create tiled images for the Resource toolbar
  148.     when it is in color mode.  Edit this toolbar bitmap along with the
  149.     array in MAINFRM.CPP to add more toolbar buttons.
  150.  
  151. RES\MBROWSE.BMP
  152.     This bitmap file is used to create tiled images for the Browse toolbar
  153.     when it is in mono mode.  Edit this toolbar bitmap along with the
  154.     array in MAINFRM.CPP to add more toolbar buttons.
  155.  
  156. RES\MDEBUG.BMP
  157.     This bitmap file is used to create tiled images for the Debug toolbar
  158.     when it is in mono mode.  Edit this toolbar bitmap along with the
  159.     array in MAINFRM.CPP to add more toolbar buttons.
  160.  
  161. RES\MEDTHORZ.BMP
  162.     This bitmap file is used to create tiled images for the Edit toolbar
  163.     when it is horizontally oriented and in mono mode.  Edit this toolbar
  164.     bitmap along with the array in EDITBAR.CPP to add more toolbar buttons.
  165.  
  166. RES\MEDTVERT.BMP
  167.     This bitmap file is used to create tiled images for the Edit toolbar
  168.     when it is vertically oriented and in mono mode.  Edit this toolbar
  169.     bitmap along with the array in EDITBAR.CPP to add more toolbar buttons.
  170.  
  171. RES\MMAIN.BMP
  172.     This bitmap file is used to create tiled images for the Main toolbar
  173.     when it is in mono mode.  Edit this toolbar bitmap along with the
  174.     array in MAINFRM.CPP to add more toolbar buttons.
  175.  
  176. RES\MPALETTE.BMP
  177.     This bitmap file is used to create tiled images for the Palette toolbar
  178.     when it is in mono mode.  Edit this toolbar bitmap along with the
  179.     array in MAINFRM.CPP to add more toolbar buttons.
  180.  
  181. RES\MRESRC.BMP
  182.     This bitmap file is used to create tiled images for the Resource toolbar
  183.     when it is in mono mode.  Edit this toolbar bitmap along with the
  184.     array in MAINFRM.CPP to add more toolbar buttons.
  185.  
  186. DOCKTOOL.RC
  187.     This is a listing of all of the Microsoft Windows resources that the
  188.     program uses.  It includes the icons, bitmaps, and cursors that are stored
  189.     in the RES subdirectory.  This file can be directly edited in the
  190.     Visual C++ development environment.
  191.