Active Document Servers

Active document servers such as Word, Excel, or PowerPoint host documents of other application types called active documents. Unlike OLE embedded objects (which are simply displayed within the page of another document), Active documents provide the full interface and complete native functionality of the server application that creates them. Users can create documents using the full power of their favorite applications (if they are active document enabled), yet can treat the resulting project as a single entity.

Active documents can have more than one page and are always in-place active. Active documents control part of the user interface, merging their menus with the File and Help menus of the container. They occupy the entire editing area of the container and control the views and the layout of the printer page (margins, footers, and so on).

MFC implements active document servers with document/view interfaces, command dispatch maps, printing, menu management, and registry management. Specific programming requirements are discussed in active documents.

MFC supports active documents with the CDocObjectServer class, derived from CCmdTarget, and CDocObjectServerItem, derived from COleServerItem. MFC supports active document containers with the COleDocObjectItem class, derived from COleClientItem.

CDocObjectServer maps the active document interfaces and initializes and activates an active document. MFC also provides macros to handle command routing in ACTIVE documents. To use active documents in your application, include AfxDocOb.h in your StdAfx.h file.

A regular MFC server hooks up its own COleServerItem-derived class. The MFC Application Wizard generates this class for you if you select the Mini-server or Full-server check box to give your application server compound document support. If you also select the Active document server check box, the MFC Application Wizard generates a class derived from CDocObjectServerItem instead.

The COleDocObjectItem class allows an OLE container to become an active document container. You can use the MFC Application Wizard to create an active document container by selecting the Active document container checkbox in the Compound Document Support page of the MFC Application Wizard. For more information, see Creating an Active Document Container Application.

See Also


Active Document Containment