Udostępnij za pośrednictwem


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
'Usage
Dim instance As IVsCodeWindow
[InterfaceTypeAttribute()]
[GuidAttribute("8560CECD-DFAC-4F7B-9D2A-E6D9810F3443")]
public interface IVsCodeWindow
[InterfaceTypeAttribute()]
[GuidAttribute(L"8560CECD-DFAC-4F7B-9D2A-E6D9810F3443")]
public interface class IVsCodeWindow
public interface IVsCodeWindow

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 Findand 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 Interaction Between Logical Views and Physical 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 illustrations of the implementation and/or calling of this interface in the Figures Edit and Solution Extendersamples.

See Also

Reference

IVsCodeWindow Members

Microsoft.VisualStudio.TextManager.Interop Namespace