Share via


In-Place Activation

If your editor view hosts ActiveX or other active controls, you must implement your editor view either as an ActiveX control or as an active document data object using the in-place activation model.

Support for Menus, Toolbars, and Commands

Visual Studio allows your editor view to use the menus and toolbars of the IDE. These extensions are referred to as OLE in-place components. For more information, see the IOleInPlaceComponent and IOleInPlaceComponentUIManager.

If you implement an ActiveX control, you can host other embedded objects. If you implement a document data object, the window frame constrains your ability to use ActiveX controls.

Note

The IOleDocument and IOleDocumentView interfaces allow for a separation of data and view. However, Visual Studio does not support this functionality, and these interfaces are used only to represent the document view object.

Editors that use the SOleComponentUIManager service can provide menu, toolbar, and command integration by calling the methods of the IOleInPlaceComponentUIManager interface implemented by the SOleComponentUIManager service. Editors can also offer other Visual Studio functionality, such as selection tracking and undo management. For more information, see Creating Custom Editors and Designers.

Objects and Interfaces Used

The objects that are used to create in-place activation are shown in the following illustration.

In-place Activation Editor
In-place activation editor

Note

Of the objects in this drawing, only the CYourEditorFactory object is required to create a standard editor. If you are creating a custom editor, you are not required to implement IVsPersistDocData2 because your editor will likely have its own private persistence mechanism. For more information, see Creating Custom Editors and Designers.

All interfaces that are implemented to create an in-place activation editor are shown on the single CYourEditorDocument object, but this configuration only supports a single view of document data. For more information about supporting multiple views of your document data, see Supporting Multiple Document Views.

Interface Type of object Use
IOleInPlaceComponent View Enables in-place VSPackage objects to operate as fully integrated components of the IDE by using the SOleComponentUIManager service. This service integrates the menus, toolbars, and commands of the object into the IDE and issues notifications of state changes.
IOleObject View Principal means by which an embedded object provides basic functionality to its container and communicates with it.
IOleInPlaceActiveObject View Manages the activation and deactivation of in-place objects, and determines how much of the in-place object should be visible.
IOleInPlaceObject View Provides a direct channel of communication between an in-place object, the associated application's outermost frame window, and the document window in the application that contains the embedded object.
IOleDocument View Implements an ActiveX object. Note that the methods of IOleDocument and T:Microsoft.VisualStudio.OLE.Interop.IOleDocumentView that separate document data and view are not used in the IDE .
IOleCommandTarget View/Data Enables the document data object or the document view object or both to participate in command handling.
IVsStatusbarUser View Enables status bar updates.
IVsToolboxUser View Enables adding items to the Toolbox.
IVsFileChangeEvents Data Sends notification of changes to the edited file. (This interface is optional.)
IPersistFileFormat Data Used to enable the Save As feature for a file type.
IVsPersistDocData Data Enables persistence for the document. For read-only files, call SetDocDataReadOnly to provide the "lock" icon that indicates read-only files.
IVsDocDataFileChangeControl Data Determines whether changes to document data should be ignored.