IVsMultiViewDocumentView Interface

Supports multiple view tabs on the same view, such as the HTML and Design tabs on the HTML editor.

Namespace:  Microsoft.VisualStudio.Shell.Interop
Assembly:  Microsoft.VisualStudio.Shell.Interop (in Microsoft.VisualStudio.Shell.Interop.dll)

[GuidAttribute("0F4B629E-8C34-4B5E-A450-F9F8DCFE3009")]
[InterfaceTypeAttribute()]
public interface IVsMultiViewDocumentView

The IVsMultiViewDocumentView type exposes the following members.

  NameDescription
Public methodActivateLogicalViewIdentifies which view is activated when the editor window is instantiated.
Public methodGetActiveLogicalViewDetermines which logical view is active.
Public methodIsLogicalViewActiveDetermines whether the specified logical view is active.
Top

InitializeEditorInstance checks to see if the document view object implements IVsMultiViewDocumentView. If it does, InitializeEditorInstance calls ActivateLogicalView passing in the GUID of the logical view that was passed into the rguidLogicalView parameter of InitializeEditorInstance. This determines which view is activated when the editor window is shown when the editor is instantiated.

By specifying the logical view GUID, the caller of InitializeEditorInstance is able to request the specific view that matches the reason the caller is requesting the view. For example, the caller would specify LOGVIEWID_Debugging to get the view appropriate for debugging view, or LOGVIEWID_TextView to get the view appropriate for the text editor (that is, a view that implements IVsCodeWindow).

NoteNote

The Visual Studio Environment SDK does not limit developers to any particular implementation of multiple view. A VSPackage might implement a multiview document as split-screen, tabbed or other type of display.

NoteNote

The environment SDK itself does not provide native support for the various types of displays. The specific implementation a given type of display requires is done through standard windows programming.

Notes to Implementers

A VSPackage should implement IVsMultiViewDocumentView when it supports multiple types of views of the same underlying data. Implement on the document view object to support multiple tabs on the same view, like the HTML editor's "Design" and "HTML" tabs.

Notes to Callers

The environment retrieves this interface by calling QueryInterface on the document view object returned by calling GetProperty and specifying a value of VSFPROPID_DocView for the propid parameter.

Was this page helpful?
(1500 characters remaining)
Thank you for your feedback

Community Additions

ADD
Show:
© 2014 Microsoft