Using AppWizard’s Full-server Option

This step of Scribble is similar to Step 6 (Adding Context-Sensitive Help) in that you’ll start by running AppWizard with an option that you didn’t originally choose. In this case, the option is full-server support. Then you’ll copy the files and resources that AppWizard generates for an OLE Server application to your Scribble project.

To set the AppWizard options for an OLE server application

1. From the File menu, click New.

   The New dialog box appears.

2. Click the Projects tab.
   
   
3. Click MFC AppWizard (exe).
   
   
4. In the Project Name box, type Scribble.

   You’re using the same project name (Scribble) so that you can copy code that contains class names and other identifiers into your current Scribble project files.

5. In the Location box, type the path to store your new Scribble application files. Type Scratch as the new project directory, so that your project path is C:\[optional directory]\Scratch\Scribble. This creates the new Scribble project under a subdirectory named Scratch.

   Note   You must create this Scribble in a different project directory than the original Scribble.

6. Click OK.

   The MFC AppWizard - Step 1 dialog box appears.

7. Click Next in the MFC AppWizard – Step 1 and MFC AppWizard – Step 2 of 6 dialog boxes to accept the default options.
   
   
8. In the MFC AppWizard – Step 3 of 6 dialog box, click Full-server and then click Next.
   
   
9. In the MFC AppWizard – Step 4 of 6 dialog box, click Advanced.
   
   
10. In the File extension box, type scb.

    The entry in the Filter name box changes appropriately.

11. Click Close.
    
    
12. Click the Context-sensitive Help option and click Next.

    When you click Context-sensitive Help with the Full-server option, AppWizard creates:

    • The toolbar bitmap for Scribble when it runs as a server.
      
      
    • An additional .RTF file for the OLE commands that appear on the menu when Scribble is running as a server.

    You’ll copy these resources to your Scribble project later.

13. In MFC AppWizard – Step 5 of 6, click Next to accept the default options.
    
    
14. In the MFC AppWizard – Step 6 of 6 dialog box, check and modify class names and filenames to make them match the original Scribble application.
    • Select the class CScribbleView and click CScrollView in the Base class box.
      
      
    • Select the class CScribbleSrvrItem and change its name to CScribbleItem, the header filename to ScribbleItem.h, and the implementation filename to ScribbleItem.cpp.

      Notice that COleServerItem is the base class, which reflects your full-server choice.

    Important   If you are starting from the sample source code files for Step 6, rather than from a Scribble project that you have been developing step by step, you must modify the filenames and class names differently than those described in this procedure. Use the alternate filenames described in the next topic, Using Short Filenames.

    For more information about using short filenames, see the topic A Note About Long Filenames in Scribble Lesson 1.

15. Click Finish.
    
    
16. In the New Project Information dialog box, confirm the specifications and click OK.

    AppWizard creates the new files.

17. Click Yes if the following message appears:

    A Microsoft Visual C++ project with the same name is already registered at [old scribble pathname]. Do you want to replace this project in the registry?
    

    This message box appears when you have already run a previous version of Scribble, from another directory, to register it with Windows.

18. From the File menu, click Close Workspace to close the Scratch\Scribble project.

In the next procedure you’ll incorporate files and resources from this Scratch version of Scribble, into the Scribble you’ve been developing all along.