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)
Syntax
'Declaration
<GuidAttribute("0F4B629E-8C34-4B5E-A450-F9F8DCFE3009")> _
<InterfaceTypeAttribute()> _
Public Interface IVsMultiViewDocumentView
[GuidAttribute("0F4B629E-8C34-4B5E-A450-F9F8DCFE3009")]
[InterfaceTypeAttribute()]
public interface IVsMultiViewDocumentView
[GuidAttribute(L"0F4B629E-8C34-4B5E-A450-F9F8DCFE3009")]
[InterfaceTypeAttribute()]
public interface class IVsMultiViewDocumentView
[<GuidAttribute("0F4B629E-8C34-4B5E-A450-F9F8DCFE3009")>]
[<InterfaceTypeAttribute()>]
type IVsMultiViewDocumentView = interface end
public interface IVsMultiViewDocumentView
The IVsMultiViewDocumentView type exposes the following members.
Methods
| Name | Description | |
|---|---|---|
.gif "Public method") |
ActivateLogicalView | Identifies which view is activated when the editor window is instantiated. |
|
GetActiveLogicalView | Determines which logical view is active. |
|
IsLogicalViewActive | Determines whether the specified logical view is active. |
Top
Remarks
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).
Note
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.
Note
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.