Compartilhar via


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
Public method ActivateLogicalView Identifies which view is activated when the editor window is instantiated.
Public method GetActiveLogicalView Determines which logical view is active.
Public method 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.

See Also

Reference

Microsoft.VisualStudio.Shell.Interop Namespace