IVsCodeWindow Interface

Represents a multiple-document interface (MDI) child that contains one or more code views.

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

Syntax

'Declaration
<InterfaceTypeAttribute()> _
<GuidAttribute("8560CECD-DFAC-4F7B-9D2A-E6D9810F3443")> _
Public Interface IVsCodeWindow
[InterfaceTypeAttribute()]
[GuidAttribute("8560CECD-DFAC-4F7B-9D2A-E6D9810F3443")]
public interface IVsCodeWindow
[InterfaceTypeAttribute()]
[GuidAttribute(L"8560CECD-DFAC-4F7B-9D2A-E6D9810F3443")]
public interface class IVsCodeWindow
[<InterfaceTypeAttribute()>]
[<GuidAttribute("8560CECD-DFAC-4F7B-9D2A-E6D9810F3443")>]
type IVsCodeWindow =  interface end
public interface IVsCodeWindow

The IVsCodeWindow type exposes the following members.

Methods

  Name Description
Public method Close Closes the code window.
Public method GetBuffer Returns the buffer used by all views in the code window.
Public method GetEditorCaption Returns the editor caption to which editors can append custom text.
Public method GetLastActiveView Returns the last active view of the code window.
Public method GetPrimaryView Returns the top (or primary) view of a split code window.
Public method GetSecondaryView Returns the bottom (or secondary) view of a split code window.
Public method GetViewClassID Returns the text view class to change or query.
Public method SetBaseEditorCaption Appends custom text to the editor caption
Public method SetBuffer Sets the text buffer for all views in the code window.
Public method SetViewClassID Sets the text view class to change or query.

Top

Remarks

The code window hosts the views for a text buffer and provides the ability to split views. A code window is a frame window that can enclose one or more views. In MDI mode, the code window is the MDI child frame. Each language service can provide its own code window manager, which allows it to add special adornments, such as a drop-down bar, to the code window.

Notes to Implementers

The environment implements a default configuration of this interface. This implementation is typically used to support an editor, such as the core editor, by using IVsTextView to display source.

Any non-core editors or designers that support a LOGVIEWID_TextView logical view must implement IVsCodeWindow on their document view to support IDE Find and Navigate operations.

Notes to Callers

Call IVsCodeWindow to access the views associated with the code window.

An interface to the default code window implementation can be obtained by calling CreateInstance, with a class ID of CLSID_VsCodeWindow and an interface ID of IID_IVsCodeWindow. The interface is typically exposed through an instance of the core editor.

Applications that do not use the core editor, but need a code window must implement it on a document view object.

Support of IDE find operations requires full implementation of GetLastActiveView,GetPrimaryView, and GetBuffer.

An example of how to apply an IVsCodeWindow interface to either a default or to a non-standard implementation of a code window can be found in the discussion Single and Multi-tab Views.

A given code window is always owned by one language service. When the code window is created, the language service is allowed to attach an IVsCodeWindowManager instance to the code window. At the appropriate time during initialization, the code window calls AddAdornments, at which time the language service can add a drop-down bar or other widgets.

Only one text buffer can exist per code window.

See Also

Reference

Microsoft.VisualStudio.TextManager.Interop Namespace