This is a part of the Microsoft Foundation Classes C++ library. Copyright (C) 1992-1997 Microsoft Corporation All rights reserved. This source code is only intended as a supplement to the Microsoft Foundation Classes Reference and related electronic documentation provided with the library. See these sources for detailed information regarding the Microsoft Foundation Classes product. ------------------------------------------------------- DRAWCLI Sample Microsoft Foundation Classes Application ------------------------------------------------------- The DRAWCLI sample application illustrates the integration of OLE container support with application-specific features, effective use of polymorphism in C++, and Windows 95 logo compliance. OLE container support --------------------- The DRAWCLI was originally a stand-alone drawing application developed using the MFC classes. The stand-alone version of DRAWCLI was then integrated with a second skeleton version of DRAWCLI created using AppWizard's OLE Container feature. This process is similar to how the OLE Visual Editing server tutorial adds server support to create the Step 7 version of SCRIBBLE. The design of an MFC OLE container application should look essentially the same, regardless of whether you're adding OLE functionality to an existing stand-alone MFC (doc/view) application, or whether you're starting with an AppWizard-generated OLE container application. The following is a brief description of how DRAWCLI is separated into application-specific code and OLE container-specific code. Class CDrawObj, implemented in DRAWOBJ.CPP, is a base class for derived "shape" classes. This base class handles hit testing of shapes, moving of shapes, and resizing of shapes. Through the use of polymorphism, DRAWCLI can interact with objects of different classes through CDrawObj's interface. Classes CDrawRect and CDrawPoly are derived from CDrawObj. CDrawRect is used to draw rectangles, rounded rectangles, ellipses, and lines. CDrawPoly is used to draw polygons. These two classes are independent of DRAWCLI's OLE container functionality. Class CDrawOleObj is also derived from CDrawObj, and is used to represent OLE embedded objects. CDrawOleObj delegates any OLE-specific operation to a contained CDrawItem object (described below). For generic shape operations, OLE embedded objects are treated like other shape objects in DRAWCLI because CDrawOleObj is derived from CDrawObj. Class CDrawItem, derived from COleClientItem, handles all the OLE-specific behavior for the OLE embedded object. The implementation of CDrawItem is similar to the implementation of the COleClientItem-derived classes in the CONTAIN and OCLIENT samples. Class CDrawDoc is derived from COleDocument. The document object maintains a CObjList of CDrawObj objects. CDrawDoc delegates several OLE container-specific menu commands, such as Edit Paste, Paste Link, and Links, to the base class COleDocument. Class CDrawView is derived from CScrollView. The OLE-specific implementation of CDrawView is similar to the implementation of the view classes in the CONTAIN and OCLIENT samples. The bulk of DRAWCLI's drawing-specific user interface is also implemented in CDrawView. Windows 95 Logo compliance -------------------------- All MFC applications meet some of the requirements for the Windows 95 logo: having a Win32 executable, support for long filenames, support for UNC pathnames, use of system colors and metrics, and compatibility with Windows NT. DRAWCLI meets the remaining requirements for the Windows 95 logo by including the following features: - OLE support. DRAWCLI is an OLE container that stores its files in the compound file format, supports in-place activation, and acts as a drop target for drag-and-drop operations. - MAPI support. DRAWCLI provides a "Send as Mail" message on its File menu, allowing the user to send a document as a mail attachment. - Compliance with Win95 shell guidelines, including registration of large and small icons, use of the system registry instead of an .INI file, and having a setup and an uninstall program. For the latter, DRAWCLI includes a script compatible with InstallSHIELD, Stirling Software’s toolkit for creating setup and uninstall programs. DRAWCLI also meets the following recommendations for Windows 95 applications: - Use of tabbed property pages. - Use of Windows 95 common controls. - Displays a shortcut menu in response to a right-button mouse click. - Storing Summary Information with its documents. In order to use the setup script (SETUP.RUL), you must first install InstallSHIELD from the \ishield directory on the CD-ROM. Then create a directory tree with the following structure: +--+--DISK1 | +--DATA | +--PROGRAM | +--SHARED | +--SAMPLES | +--HELP In the DATA directory, create a file named README.TXT (you can use this file). In the PROGRAM subdirectory, place a copy of DRAWCLI.EXE. In the SHARED subdirectory, place copies of MFC40.DLL, MFCO40.DLL, and MSVCRT40.DLL. In the SAMPLES subdirectory, create a file called SAMPLE.DRW. In the HELP subdirectory, create a file called DUMMY.HLP.(DRAWCLI does not currently support online help; this file is strictly a placeholder for demonstrating the setup program.) In the DISK1 directory, create an empty file named DISK1.ID. This acts as a disk identifier. Using InstallSHIELD's ICOMP.EXE, compress all the DRAWCLI files into a file named DATA.Z using the following command: > icomp data\*.* disk1\data.z -i Using InstallSHIELD's COMPILE.EXE, compile the script SETUP.RUL into SETUP.INS using the following command: > compile setup.rul Using InstallSHIELD's PACKLIST.EXE, compile the file SETUP.LST into SETUP.PKG using the following command: > packlist setup.lst Copy the following files to a floppy disk: (from \Program Files\Stirling\InstallSHIELD\Program) - SETUP.EXE - UNINST.EXE - _SETUP.DLL - _SETUP.LIB (from the directory where you placed DRAWCLI) - SETUP.INS - SETUP.PKG (from your DISK1 subdirectory) - DISK1.ID - DATA.Z The resulting floppy disk can be used to install DRAWCLI. See the InstallSHIELD documentation for more information.