Menus and Resources: Menu Merging

HomeOverviewHow Do ISampleTutorial

This article details the steps necessary for OLE document applications to handle visual editing and in-place activation properly. In-place activation poses a challenge for both container and server (component) applications. The user remains in the same frame window (within the context of the container document), but is actually running another application, the server. This requires coordination between the resources of the container and server applications.

Topics covered in this article include:

Menu Layouts

The first step is to coordinate menu layouts.

For more information, see Menu Creation in the Win32 SDK.

Container applications should create a new menu to be used only when embedded items are activated in place. At the minimum, this menu should consist of the following, in the order listed:

  1. File menu identical to the one used when files are open. (Usually no other menu items are placed before the next item.)

  2. Two consecutive separators.

  3. Window menu identical to the one used when files are open (only if the container application in an MDI application). Some applications may have other menus, such as an Options menu, that belong in this group, which remains on the menu when an embedded item is activated in place.

Note   There may be other menus that affect the view of the container document, such as Zoom. These container menus appear between the two separators in this menu resource.

Server (component) applications should also create a new menu specifically for in-place activation. It should be like the menu used when files are open, but without menu items, such as File and Window that manipulate the server document instead of the data. Typically, this menu consists of the following:

  1. Edit menu identical to the one used when files are open.

  2. Separator.

  3. Object editing menus, such as the Pen menu in the Scribble tutorial application.

  4. Separator.

  5. Help menu.

For an example, look at the layout of some sample in-place menus for a container and a server. The details of each menu item have been removed to make the example clearer. The container’s in-place menu has the following entries:

IDR_CONTAINERTYPE_CNTR_IP MENU PRELOAD DISCARDABLE 
BEGIN
    POPUP "&File C1"
    MENUITEM SEPARATOR
    POPUP "&Zoom C2"
    MENUITEM SEPARATOR
    POPUP "&Options C3"
    POPUP "&Window C3"
END

The consecutive separators indicate where the first part of the server’s menu should go. Now look at the server’s in-place menu:

IDR_SERVERTYPE_SRVR_IP MENU PRELOAD DISCARDABLE 
BEGIN
    POPUP "&Edit S1"
    MENUITEM SEPARATOR
    POPUP "&Format S2"
    MENUITEM SEPARATOR
    POPUP "&Help S3"
END

The separators here indicate where the second group of container menu items should go. The resulting menu structure when an object from this server is activated in place inside this container looks like this:

BEGIN
    POPUP "&File C1"
    POPUP "&Edit S1"
    POPUP "&Zoom C2"
    POPUP "&Format S2"
    POPUP "&Options C3
    POPUP "&Window C3"
    POPUP "&Help S3"
END

As you can see, the separators have been replaced with the different groups of each application’s menu.

Accelerator tables associated with the in-place menu should also be supplied by the server application. The container will incorporate them into its own accelerator tables.

When an embedded item is activated in place, the framework loads the in-place menu. It then asks the server application for its menu for in-place activation and inserts it where the separators are. This is how the menus combine. You get menus from the container for operating on the file and window placement, and you get menus from the server for operating on the item.

Toolbars and Status Bars

Server applications should create a new toolbar and store its bitmap in a separate file. AppWizard-generated applications store this bitmap in a file called ITOOLBAR.BMP. The new toolbar replaces the container application’s toolbar when your server’s item is activated in place, and should contain the same items as your normal toolbar, but remove icons representing items on the File and Window menus.

This toolbar is loaded in your COleIPFrameWnd-derived class, created for you by AppWizard. The status bar is handled by the container application. For more information on the implementation of in-place frame windows, see the article Servers: Implementing a Server.

See Also   Activation, Servers, Containers