IVsTextMarkerContextProvider Interface
Provides context for text markers in the core editor.
Namespace: Microsoft.VisualStudio.TextManager.Interop
Assembly: Microsoft.VisualStudio.TextManager.Interop (in Microsoft.VisualStudio.TextManager.Interop.dll)
Syntax
'Declaration
<GuidAttribute("F1671B6B-1090-4DFF-BBFD-133EB428BB6C")> _
<InterfaceTypeAttribute()> _
Public Interface IVsTextMarkerContextProvider
[GuidAttribute("F1671B6B-1090-4DFF-BBFD-133EB428BB6C")]
[InterfaceTypeAttribute()]
public interface IVsTextMarkerContextProvider
[GuidAttribute(L"F1671B6B-1090-4DFF-BBFD-133EB428BB6C")]
[InterfaceTypeAttribute()]
public interface class IVsTextMarkerContextProvider
[<GuidAttribute("F1671B6B-1090-4DFF-BBFD-133EB428BB6C")>]
[<InterfaceTypeAttribute()>]
type IVsTextMarkerContextProvider = interface end
public interface IVsTextMarkerContextProvider
The IVsTextMarkerContextProvider type exposes the following members.
Methods
| Name | Description | |
|---|---|---|
.gif "Public method") |
RemoveLastContext | Deprecated. Do not use. |
|
UpdateContextForMarker | Called by the language service to indicate that the context for a text marker should be added to the context bag. |
Top
Remarks
For each text marker type in the core editor, the environment creates a separate IVsTextMarkerContextProvider object (text marker). Whenever the cursor in an editor is over a text marker, the environment queries to see if the IVsTextMarkerContextProvider interface is implemented. If this interface is implemented, then the environment calls UpdateContextForMarker and passes a pointer to the context bag for the editor. Write your implementation of this method so that when called by the environment, you update the context for the text marker in the editor's context bag. For more information, see IVsUserContext::AddAttribute.
When the editor's cursor moves off of the text marker, the environment calls UpdateContextForMarker and passes you a pointer to the editor's context bag to allow you to remove the context for the last text marker. For more information, see RemoveAttribute.
Note
The Visual Studio core editor provides the text marker in addition to the keyword at the cursor during updates.
Use the following steps to add context for text markers to the Dynamic Help window:
Turn on the MV_CONTEXT_CONTRIBUTION_FOR_BODY visual style bit by calling SetVisualStyle and specifying this value.
When you create the text marker, pass in a text marker client (IVsTextMarkerClient) that also implements IVsTextMarkerContextProvider.
Your IVsTextMarkerContextProvider implementation is called twice every time context is to be added, once when the context is added and once more when the context is to be removed.
Notes to Implementers
Implemented by the language service to provide context for text markers (for example, compiler errors) in the Visual Studio core editor. The core editor calls QueryInterface on IVsTextLayerMarker to return a pointer to IVsTextMarkerContextProvider.
Notes to Callers
Called by the Visual Studio core editor to indicate that context is updating.